Trang này được dịch bằng máy. Đọc bản gốc tiếng Anh.

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`.

Nguồn gốc

Chính thứcĐược ký bởi một danh tính ký mà danh mục này công nhận là nhà phát hành chính thức.
Digest nội dung
sha256:f18ddfb195f109038457d006de50752a385ac09898522d173af030fa6f8d5cbd
Đã xuất bản
2026-11-10T10:13:09Z
Danh tính ký
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main

Chữ ký

  • Chính thứcapplication/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

Tham chiếu ở phiên bản này

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

Tham số của nhà phát triển

Các giá trị mà nhà phát triển đặt trong Aggregate.

TênKiểuMặc địnhBắt buộcMô tả
retention_periodstring168hkhôngHow long stored log streams are kept before the in-process compactor deletes them. Expressed as a Go duration (e.g. `168h` for seven days).

Định cỡ của người vận hành

Định cỡ hạ tầng mà người vận hành tinh chỉnh theo từng môi trường.

TênKiểuMặc địnhBắt buộcMô tả
source_versionstring—khôngSource 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—không—
storageobject—không—
overridesobject (open)—khôngProvider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

Hợp đồng đầu ra

Các giá trị mà thành phần này xuất bản cho bên tiêu thụ qua cấu trúc liên kết uses.

TênKiểuMặc địnhBắt buộcMô tả
hoststring—có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—có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—khôngHow 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—khôngThe base address OpenTelemetry logs are received at — `http://<host>:<port>/otlp`. An OTLP HTTP exporter given it appends `/v1/logs` itself.
metrics_endpointstring—khôngThe 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.

Các socket uses

Các socket phụ thuộc mà thành phần này kết nối qua. Đích của mọi kết nối được nối qua một socket phải thỏa mãn bộ chọn nhãn của socket đó, và mỗi kết nối có thể mang theo phần đính kèm trong các slot mà socket khai báo. Một slot bắt buộc phải được đáp ứng bởi mỗi kết nối mà Aggregate hoặc Release nối qua socket.

chunk_cache

Bộ chọn
component.aggrega.ai/category=datastore
Tiêm
env

Các slot mà mỗi kết nối qua socket này có thể lấp đầy

SlotBộ chọnBắt buộcTiêmNhạy cảmMô tả
server_cafeature.aggrega.ai/kind=secretkhôngfilecó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.

Slot đính kèm

Các điểm liên kết có tên mà tại đó một Feature được gắn vào thành phần này. Bộ chọn của một slot giới hạn Feature nào có thể lấp đầy nó, và danh sách tiêm của slot nêu cách nội dung của Feature có thể được chuyển giao. Một slot bắt buộc phải được liên kết trên mọi thể hiện, bằng một phần đính kèm trên thể hiện đó hoặc ở một phạm vi phía trên nó, và một slot nhạy cảm được khai báo để xử lý nội dung bí mật. Một Feature cũng có thể được gắn dưới một tên mà không slot nào khai báo.

Chưa khai báo slot đính kèm nào.

Danh sách cho phép tự tiêm

env

Quan hệ

Các cạnh có kiểu đi tới và đi từ các thực thể đã xuất bản khác. Một tham chiếu không có đích đã xuất bản được hiển thị là một cạnh bị đứt thay vì một liên kết.

Sử dụng

Được sử dụng bởi

Tài liệu tham khảo khái niệm Component →

Danh mục Aggrega — chỉ mục mở gồm các thành phần, tính năng, công thức và các plugin kết xuất chúng.

Được xây dựng bằng hệ thống thiết kế dùng chung của Aggrega.

Quyền riêng tư