Цю сторінку перекладено машинно. Читати англійський оригінал.

Component

core/observability/loki

A Grafana Loki log-aggregation server. Loki receives log streams from shippers and agents over its HTTP push API, indexes them by label rather than by full-text content, stores them in a chunk object store, and answers log-query and range requests over the same HTTP API. This component models Loki in its single-binary shape: every Loki subsystem — distributor, ingester, querier, compactor — runs inside one process backed by a local filesystem chunk store, so it renders as a single stateful server with a data volume rather than a set of microservices. A memcached may be wired to the optional `chunk_cache` socket to hold decompressed chunks between queries; the per-connection values on that edge — batch size, parallelism, timeout and entry lifetime — tune how this server drives that one cache, and with nothing wired the server runs without a chunk cache. The socket takes one connection, and a second halts the build, as does a target publishing a protocol other than memcached or memcached-tls, or none. Its contract to consumers is that HTTP endpoint: a log shipper pushes streams to it, and a dashboards server reads them back over the query API. It also receives OpenTelemetry logs at the base address it publishes as `otlp_http_endpoint`, and carries `observability.aggrega.ai/logs: otlp-http`, so an OpenTelemetry Collector's `logs` socket takes it. Realized on helm by `loki`, which sources the official Grafana Loki chart, and on compose by `loki`, a compose service running the same image and publishing nothing to the host. Loki serves its own metrics in the Prometheus format at /metrics on its HTTP port, on by default, and every Recipe publishes that address as `metrics_endpoint`.

Походження

ОфіційнийПідписано ідентичністю підписувача, яку цей каталог визнає офіційним видавцем.
Дайджест вмісту
sha256:f18ddfb195f109038457d006de50752a385ac09898522d173af030fa6f8d5cbd
Опубліковано
2026-11-10T10:13:09Z
Ідентичність підписувача
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Підпис

  • Офіційнийapplication/vnd.dev.sigstore.bundle.v0.3+json

    https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

    sha256:e3c0b97a1f971a3f4c1a90a0c14c522f1587e2d3d131e4555d3873539925974f

Посилання на цю версію

oci://hub.aggrega.ai/component/core/observability/loki:1.0.0

Параметри розробника

Значення, які розробник задає в сутності Aggregate.

НазваТипТипове значенняОбов’язковеОпис
retention_periodstring168hніHow long stored log streams are kept before the in-process compactor deletes them. Expressed as a Go duration (e.g. `168h` for seven days).

Розміри, задані оператором

Розміри інфраструктури, які оператор налаштовує для кожного середовища.

НазваТипТипове значенняОбов’язковеОпис
source_versionstring—ніSource artifact version (Helm chart). Overrides the helm Recipe's default source version; the compose realization pulls no source artifact and ignores it. Changing from default does not guarantee value mapping compatibility.
computeobject—ні—
storageobject—ні—
overridesobject (open)—ніProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Вихідний контракт

Значення, які цей компонент публікує для споживачів через топологію uses.

НазваТипТипове значенняОбов’язковеОпис
hoststring—такName the push and query API is reached at — the in-cluster Service on helm, the service name on compose. A shipper sending log streams and a dashboard querying them both dial this name.
portinteger—такTCP port the push and query API is served on. Each realization serves the project's own default, so a consumer reads this rather than hard-coding one.
protocolstring—ніHow the published address is spoken to — `http`, so a consumer reaches both the push and the query paths with an HTTP client.
otlp_http_endpointstring—ніThe base address OpenTelemetry logs are received at — `http://<host>:<port>/otlp`. An OTLP HTTP exporter given it appends `/v1/logs` itself.
metrics_endpointstring—ніThe full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:<port>/metrics` on the push and query API. Empty where the component serves none reachable.

Сокети uses

Сокети залежностей, через які під’єднується цей компонент. Ціль кожного з’єднання, прокладеного через сокет, має задовольняти його селектор міток, а кожне з’єднання може нести приєднання в слотах, які оголошує сокет. Обов’язковий слот має заповнити кожне з’єднання, яке сутність Aggregate або сутність Release прокладає через сокет.

chunk_cache

Селектор
component.aggrega.ai/category=datastore
Ін’єкція
env

Слоти, які може заповнити кожне з’єднання через цей сокет

СлотСелекторОбов’язковеІн’єкціяЧутливийОпис
server_cafeature.aggrega.ai/kind=secretніfileтакOptional authority the server checks the cache's certificate against while the cache publishes protocol memcached-tls, where the image does not already trust the authority that signs it. Its Secret holds ca.crt. The Kubernetes realization mounts the whole Secret read-only into the server and names the file in its chunk-cache client; the Compose realization refuses it, since no credential Feature realized there delivers a Secret as files. The build halts on a server_ca publishing no Secret name, and on one wired to a cache served without TLS. Fill it with core/referenced-secret.

Слоти приєднання

Іменовані точки прив’язки, у яких сутність Feature приєднується до цього компонента. Селектор слота обмежує, яка сутність Feature може його заповнити, а його список inject визначає, як можна доставити матеріал сутності Feature. Обов’язковий слот має бути прив’язаний у кожному екземплярі, приєднанням в екземплярі або в області вище за нього, а чутливий слот оголошено для роботи з секретним матеріалом. Сутність Feature також може приєднатися під назвою, яку не оголошує жоден слот.

Слотів приєднання не оголошено.

Список дозволених самоін’єкцій

env

Зв’язки

Типізовані ребра до інших опублікованих сутностей і від них. Відсилання без опублікованої цілі відображається як розірване ребро, а не як посилання.

Використовує

Використовується в

Довідка про поняття Component →

Каталог Aggrega — відкритий індекс компонентів, функцій, рецептів і плагінів, які їх рендерять.

Створено на основі спільної дизайн-системи Aggrega.

Конфіденційність