Grafana Cloud aus den offiziellen Dokumentationen
Abgedeckte Version: Grafana Cloud wird kontinuierlich veröffentlicht, ohne Versionsauswahl. OSS-Seiten (Grafana, Mimir, Loki, Tempo) werden in der aktuellsten Version gelesen.
Jede Angabe enthält den Link zur entsprechenden Dokumentation. Lesen Sie zuerst die Kurzanleitung, dann die passende Referenz. Siehe „Alte Patterns“ für alte Konfigurationen.
Kurzanleitung
Anmeldedaten
- Access-Policy-Tokens öffnen Telemetrie und die Cloud API, niemals die HTTP-API der Instanz. Dashboards, Ordner, Benutzer und Datenquellen benötigen ein Service-Account-Token. Service-Account-Tokens und Cloud-API-Access-Policy-Tokens werden in
Authorization: Bearer <TOKEN>verwendet. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/access-policies/ und https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/authentication/ - Keiner der Token-Typen läuft standardmäßig ab. Legen Sie ein Ablaufdatum fest – eine Policy pro Aufgabe. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/access-policies/create-access-policies/ und https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/service-accounts/
- Telemetrie-Basic-Auth: Benutzer = numerische Instanz-ID, Passwort = Access-Policy-Token mit dem passenden
*:write- oder*:read-Bereich. https://grafana.com/docs/grafana-cloud/send-data/traces/set-up/verify-ingestion/
OTLP-Ingestion
- Kopieren Sie den OTLP-Endpunkt aus der OpenTelemetry-Kachel des Stacks. Regionen, die vor dem 15.01.2026 erstellt wurden, verwenden flache Hostnamen, spätere verschachtelte – bauen Sie ihn daher niemals aus einer Vorlage auf. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/account-management/region-url-formats/
- Signal-spezifische
OTEL_EXPORTER_OTLP_*_ENDPOINT-Variablen benötigen den vollständigen/otlp/v1/<signal>-Pfad. Die Basisvariable hängt diesen automatisch an. https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/ - Metriknamen erhalten
_für Punkte und Einheit- oder_total-Suffixe. Ressourcenattribute werden intarget_infoaggregiert, verknüpft überjobundinstance. https://grafana.com/docs/grafana-cloud/send-data/otlp/otlp-format-considerations/
Abfragen
- PromQL: Immer
[$__rate_interval]verwenden und das Scrape-Intervall der Datenquelle auf das tatsächliche setzen (Standard15s). Multi-Value-Variablen benötigen=~. https://grafana.com/docs/grafana/latest/datasources/prometheus/template-variables/ - Mimir-Label-APIs: Immer
startundendübergeben. https://grafana.com/docs/mimir/latest/query/query-metric-labels/ - LogQL: Zuerst Selektor, dann Zeilenfilter, dann Parser.
{app=~".*"}wird abgelehnt – stattdessen.+verwenden. Vorunwrapimmer__error__ = ""filtern. https://grafana.com/docs/loki/latest/query/bp-query/, https://grafana.com/docs/loki/latest/query/troubleshoot-query/ und https://grafana.com/docs/loki/latest/query/query_examples/ - TraceQL: Bedingungen in einem
{}beziehen sich auf einen Span. Jedes Attribut mit Bereichsangabe versehen.&&bevorzugen, da||langsamer ist. Unscopeddurationbezieht sich auf den Span. https://grafana.com/docs/tempo/latest/traceql/construct-traceql-queries/ und https://grafana.com/docs/tempo/latest/traceql/tune-traceql-queries/
Kosten und Limits
- Die Halbierung des Scrape-Intervalls verdoppelt die Datenpunkte pro Minute und Serie. Pro enthält 1 DPM pro Serie, der Rest kostet extra.
sum(foo)liest genauso viele Samples wiefoo. https://grafana.com/docs/grafana-cloud/platform/pricing-and-usage/metrics/ - Loki-Streams haben standardmäßig maximal 15 Labels. IDs in strukturierte Metadaten auslagern. https://grafana.com/docs/grafana-cloud/send-data/logs/loki-limits/
Alerting
- Standardmäßig Grafana-verwaltete Regeln. Bei „No Data“- und „Error“-Zuständen werden separate
DatasourceNoData- /DatasourceError-Alarme mit eigenen Labels ausgelöst. Daher können Stummschaltungen, Mute-Timings und Richtlinien des ursprünglichen Alarms für diese nicht gelten. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/alert-rule-evaluation/nodata-and-error-states/ - Nur Labels routen. Ein Wert in einer Annotation fällt auf die Standardrichtlinie zurück. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/alert-rules/annotation-label/
- Geschwister stoppen bei der ersten passenden Richtlinie, es sei denn, „Continue matching siblings“ ist aktiviert. Mute-Timings werden nur an untergeordnete Richtlinien angehängt und nicht vererbt. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/notifications/notification-policies/ und https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/configure-notifications/mute-timings/
- Cloud hat kein File-Provisioning. Das Provisioning des Richtlinienbaums überschreibt alle Richtlinien. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/set-up/provision-alerting-resources/ und https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/set-up/provision-alerting-resources/export-alerting-resources/
Synthetic Monitoring
- Jeder ausgewählte Probe erreicht das Ziel bei jedem Intervall – nahezu gleichzeitig. https://grafana.com/docs/grafana-cloud/observe-and-act/testing/synthetic-monitoring/introduction/
- MultiHTTP validiert keinen 200-Status automatisch. Für jede Anfrage Assertions definieren. https://grafana.com/docs/grafana-cloud/observe-and-act/testing/synthetic-monitoring/create-checks/checks/multihttp/
Dashboards
- Die Dashboard-API adressiert Dashboards über
metadata.name(die UID), nicht über das Feldmetadata.uid. Der Cloud-Namespace iststacks-<STACK_ID>. https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/dashboard/ und https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/apis/
Alte Patterns
Referenzdateien
| Datei | Lesen für |
|---|---|
| references/otlp-ingestion.md | OTLP-Endpunkt, Metrikumbenennung, target_info, Ingestion-Fehler, OTLP-Logs |
| references/traces-and-traceql.md | Trace-Limits, Sampling, Metrics-Generator, Exemplare, TraceQL |
| references/metrics-promql-and-cardinality.md | PromQL-Kosten, Label-APIs, Abrechnung, Limits, Adaptive Metrics |
| references/logs-and-logql.md | LogQL-Reihenfolge, Parser, Cloud-Log-Limits, Abrechnung |
| references/alert-rules.md | Regeltypen, Zustände, No Data und Error, Labels, Recording Rules |
| references/notifications-and-alerting-provisioning.md | Contact Points, Richtlinien, Mute-Timings, Templates, Provisioning |
| references/synthetic-monitoring.md | Check-Typen, MultiHTTP, k6-Checks, Probes, Uptime, Alarme |
| references/dashboards-and-as-code.md | Variablen, JSON-Modell, Dashboard-API, Terraform, Foundation SDK |
| references/access-tokens-and-apis.md | Access Policies, Bereiche, Service Accounts, /apis-Pfade |
Quellen und Lesedetails sind in SOURCES.md aufgelistet.