本页面为机器翻译。阅读英文原文。

Component

core/observability/thanos-store

Thanos Store Gateway, the read side of a Thanos metrics stack. The Store Gateway reads historical metric blocks from an S3-compatible object store and serves them to queriers over its StoreAPI on a gRPC port. The object store it reads from is wired through its `objstore` uses-socket: the endpoint the store publishes gives the S3 endpoint in the object-store configuration, and its scheme whether that connection is plain HTTP or TLS. Credentials reach the process as environment variables through the AWS SDK credential chain rather than being embedded in that configuration, so the rendered configuration carries no secret: the access key's secret half is the connection's `credential`, and its identifier the connection's `credential_id` where one is attached, else the `s3_access_key` value. The Store Gateway keeps only an ephemeral local cache of index data — the object store is the system of record — so it renders as a stateless server. Exports its StoreAPI host, port, and protocol to consumers via the uses topology. The gateway serves its own metrics in the Prometheus format at /metrics on its HTTP port, not the published StoreAPI port, and publishes that address as `metrics_endpoint`.

来源

官方由本目录认定为官方发布者的签名身份签名。
内容摘要
sha256:d72db93af276a5cf3f877eea9d563e888ed7e96587318aa71688d73fe939f37d
发布时间
2026-11-10T10:13:20Z
签名身份
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:c98c2833eb7473faf6e304aa4b848670713311d41b2f33a638f1510c942d5215

此版本的引用

oci://hub.aggrega.ai/component/core/observability/thanos-store:1.0.0

开发者参数

开发者在 Aggregate 中设置的值。

名称类型默认值必需描述
s3_access_keystringadmin否S3 access-key identifier presented to the object store where the `objstore` connection carries no `credential_id`; a `credential_id` attached there is presented in its place. Its secret is the `credential` the `objstore` connection carries.
bucketstringthanos否Object-store bucket the Store Gateway reads metric blocks from. The bucket must be pre-created out of band; the read tier does not provision it. Where the store wired to `objstore` publishes a bucket of its own, this names the same one, or the build halts.

运维规格

运维人员按环境调整的基础设施规格。

名称类型默认值必需描述
http_portinteger (min 1024, max 65535)10902否HTTP port serving health and metrics endpoints, reachable in-cluster only.
grpc_portinteger (min 1024, max 65535)10901否gRPC port serving the StoreAPI; queriers connect here.
engine_versionstringv0.42.0否Thanos container image tag.
computeobject—否—
overridesobject (open)—否Provider-specific overrides. Accepts any nested structure. Each Recipe documents which keys it reads.

输出契约

此组件通过 uses 拓扑向使用方发布的值。

名称类型默认值必需描述
hoststring—是In-cluster DNS name of the Service the gateway serves historical metric blocks on. A query front end adds this name to its store list together with `port`.
portinteger—是TCP port the store API is served on. It carries the gRPC port an operator set, never the health-and-metrics HTTP port.
protocolstring—否How the published address is spoken to — `grpc`, so a query front end dials it as a store rather than as an HTTP endpoint.
metrics_endpointstring—否The full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:<http_port>/metrics` on the HTTP port, which is not the published `port`. Empty where the component serves none reachable.

uses 套接字

此组件用于建立连接的依赖套接字。通过某个套接字接入的每个连接,其目标都必须满足该套接字的标签选择器,且每个连接都可以在该套接字声明的槽位中携带附加项。必需槽位须由 Aggregate 或 Release 通过该套接字接入的每个连接来填充。

objstore

选择器
component.aggrega.ai/type=resource,component.aggrega.ai/category=storage
注入
env

经由此套接字的每个连接可填充的槽位

槽位选择器必需注入敏感描述
credential_idfeature.aggrega.ai/kind=secret否env是Access-key identifier the Store Gateway presents to the object store this connection reaches, the identifier half of the pair whose secret half is this connection's credential, supplied as the object-store access key ID via the credential subsystem. It names an account on that store, so it matches whatever the store itself was given. Unattached, the s3_access_key value is presented instead.
credentialfeature.aggrega.ai/kind=secret否env是S3 secret key the Store Gateway presents to the object store this connection reaches, supplied as the object-store secret access key via the credential subsystem. There is no default: the build halts when nothing fills this slot, unless the connection's values set unauthenticated: true.

附加槽位

Feature 附加到此组件时所用的命名绑定点。槽位的选择器限定哪个 Feature 可以填充该槽位,其 inject 列表则指明 Feature 的内容可以如何交付。必需槽位必须在每个实例上完成绑定,可以通过实例上的附加,也可以通过其上层作用域的附加;敏感槽位则声明为用于处理机密内容。Feature 也可以以任何槽位都未声明的名称进行附加。

未声明附加槽位。

自注入允许列表

env

关系

与其他已发布实体之间的类型化边。没有已发布目标的引用会呈现为断开的边,而不是链接。

使用

被使用

Component 概念参考 →

Aggrega 目录 — 收录组件、功能、配方以及渲染它们的插件的开放索引。

基于共享的 Aggrega 设计系统构建。

隐私