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

Component

core/observability/grafana

A Grafana dashboards and visualization server. It keeps its own state — users, saved dashboards, preferences — in a local database, so it renders as a server backed by a persistent volume. It ships standalone: it declares no socket for a metrics or logs source to be wired in as a provisioned data source. Exports its web endpoint host and port to consumers. Grafana serves its own metrics in the Prometheus format at /metrics on its web port, on by default, and every Recipe publishes that address as `metrics_endpoint`. An admin account is always present: its username is a developer value and its password is wired through the optional `admin_password` credential slot. Unattached, the Recipe supplies a deterministic development default instead of a generated password, so the render stays byte-identical across runs. Realized for local development by a Compose Recipe, and on Kubernetes by two realizations the Manifest chooses between. `grafana` synthesizes the server as a workload and fetches nothing, so it is the one to reach for where the build must complete with no chart repository reachable. `grafana-chart` renders the community-maintained Grafana Helm chart, which additionally carries the server's own provisioning surface — data sources and dashboards declared in the Release through `infra.overrides` — so reach for it where a chart repository is reachable at build time.

Походження

ОфіційнийПідписано ідентичністю підписувача, яку цей каталог визнає офіційним видавцем.
Дайджест вмісту
sha256:ab7fe1c272c221228349de7a879d5fc5aa617b7bf9c72a1a0817ea27fb0637b2
Опубліковано
2026-11-10T10:12:59Z
Ідентичність підписувача
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:df5f02cc96cc0380b8a460b04b9c30d5f9011b9545fcc27dd853627ce411e716

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

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

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

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

НазваТипТипове значенняОбов’язковеОпис
admin_userstringadminніGrafana admin account username. The account is always created; its password is wired through the optional `admin_password` credential slot.

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

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

НазваТипТипове значенняОбов’язковеОпис
portinteger (min 1024, max 65535)3000ніHTTP port the Grafana web and query endpoint listens on. Most operators should omit this and let the Recipe assign the default (3000).
external_base_urlstring—ніExternally reachable base URL of the dashboards server, as assembled at the ingress tier, including any path the ingress serves it under — for example https://grafana.example.com or https://tools.example.com/grafana. The server composes from this every link it writes, the address it redirects a browser to, and the callback address it hands a sign-in provider, so a shared dashboard link and a sign-in both resolve from outside the cluster. The server keeps serving at its own root, so an ingress in front of it maps the address's path onto that root. Omitted, the server keeps its default root address, composed from its own listening port rather than from an address a browser uses, which suits a server nobody opens from outside the cluster.
engine_versionstring12.1.1ніGrafana container image tag. Selects the image tag on container targets; the chart-backed realization pins its own image tag.
source_versionstring—ніVersion of the Helm chart the chart-backed realization pulls. Read only by that realization; the workload-synthesis and Compose realizations pull no source artifact and ignore it. Changing it away from the Recipe's default does not guarantee value-mapping compatibility with the new chart.
computeobject—ні—
storageobject—ні—
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 fronting the web and query endpoint. A gateway routing browser traffic to the dashboards points its upstream at this name.
portinteger—такTCP port that Service serves the web and query endpoint on. It follows the port an operator set in the Release, so a consumer reads it rather than assuming a default.
protocolstring—ніHow the published address is spoken to — `http`, so a consumer composes an address on that scheme.
metrics_endpointstring—ніThe full address Prometheus scrapes this component's metrics at — scheme, host, port and path, `http://<host>:<port>/metrics` on the web endpoint. Empty where the component serves none reachable.

Сокети uses

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

Сокетів uses не оголошено.

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

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

СлотСелекторОбов’язковеІн’єкціяЧутливийОпис
admin_passwordfeature.aggrega.ai/kind=secretніenvтакOptional Grafana admin-password credential. When attached, supplies the admin password via the credential subsystem. Unattached, compose/grafana, helm/grafana and helm/grafana-chart set the admin password to the development literal `dev-grafana-admin-change-me`, which this catalog publishes, so every Release that leaves the slot unattached shares that password.

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

env

Зв’язки

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

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

Ця сутність не використовує нічого з каталогу.

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

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

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

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

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