Grafana Cloud d'après la documentation officielle
Version couverte : Grafana Cloud est publié en continu, sans sélecteur de version. Les pages OSS (Grafana, Mimir, Loki, Tempo) sont lues dans leur dernière version.
Chaque affirmation porte l'URL de sa documentation. Lisez le démarrage rapide, puis la référence correspondante. Voir « Anciens modèles » pour les configurations obsolètes.
Démarrage rapide
Authentification
- Les tokens de politique d'accès ouvrent l'accès à télémétrie et à l'API Cloud, jamais à l'API HTTP de l'instance. Les tableaux de bord, dossiers, utilisateurs et sources de données nécessitent un token de compte de service. Les tokens de compte de service et les tokens de politique d'accès Cloud s'utilisent dans
Authorization: Bearer <TOKEN>. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/access-policies/ et https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/authentication/ - Aucun type de token n'expire par défaut. Définissez une expiration, une politique par tâche. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/access-policies/create-access-policies/ et https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/service-accounts/
- Authentification basique pour la télémétrie : utilisateur = ID numérique de l'instance, mot de passe = token de politique d'accès avec le bon scope
*:writeou*:read. https://grafana.com/docs/grafana-cloud/send-data/traces/set-up/verify-ingestion/
Ingestion OTLP
- Copiez le point de terminaison OTLP depuis la tuile OpenTelemetry de la stack. Les régions créées avant le 15 janvier 2026 utilisent des noms d'hôte plats, les suivantes des noms imbriqués, ne le construisez donc jamais à partir d'un modèle. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/account-management/region-url-formats/
- Les variables
OTEL_EXPORTER_OTLP_*_ENDPOINTspécifiques à un signal nécessitent le chemin complet/otlp/v1/<signal>. La variable de base l'ajoute automatiquement. https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/ - Les noms de métriques remplacent les points par
_et les unités ou suffixes_total. Les attributs de ressource vont danstarget_info, joint surjobetinstance. https://grafana.com/docs/grafana-cloud/send-data/otlp/otlp-format-considerations/
Requêtes
- PromQL : utilisez toujours
[$__rate_interval]et définissez l'intervalle de scraping de la source de données sur la valeur réelle (par défaut15s). Les variables multi-valeurs nécessitent=~. https://grafana.com/docs/grafana/latest/datasources/prometheus/template-variables/ - API Mimir pour les labels : passez toujours
startetend. https://grafana.com/docs/mimir/latest/query/query-metric-labels/ - LogQL : sélecteur, puis filtres de ligne, puis analyseurs.
{app=~.*}est rejeté, utilisez.+. Filtrez__error__ = ""avantunwrap. https://grafana.com/docs/loki/latest/query/bp-query/, https://grafana.com/docs/loki/latest/query/troubleshoot-query/ et https://grafana.com/docs/loki/latest/query/query_examples/ - TraceQL : les conditions dans un seul
{}s'appliquent à une même span. Définissez la portée de chaque attribut. Préférez&&, car||est plus lent.durationnon qualifié fait référence à la span. https://grafana.com/docs/tempo/latest/traceql/construct-traceql-queries/ et https://grafana.com/docs/tempo/latest/traceql/tune-traceql-queries/
Coûts et limites
- Diviser par deux l'intervalle de scraping double le nombre de points de données par minute et par série, et Pro inclut 1 point par minute par série, le reste est facturé en supplément.
sum(foo)lit autant d'échantillons quefoo. https://grafana.com/docs/grafana-cloud/platform/pricing-and-usage/metrics/ - Les flux Loki acceptent au maximum 15 labels par défaut. Placez les ID dans les métadonnées structurées. https://grafana.com/docs/grafana-cloud/send-data/logs/loki-limits/
Alertes
- Règles gérées par Grafana par défaut. Les états « Aucune donnée » et « Erreur » déclenchent des alertes séparées
DatasourceNoData/DatasourceErroravec leurs propres labels, donc les silences, plages de silence et politiques de l'alerte d'origine peuvent ne pas s'y appliquer. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/alert-rule-evaluation/nodata-and-error-states/ - Seuls les labels sont utilisés pour le routage. Une valeur dans une annotation tombe dans la politique par défaut. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/alert-rules/annotation-label/
- Les politiques sœurs s'arrêtent à la première politique correspondante, sauf si « Continuer la correspondance avec les sœurs » est activé. Les plages de silence s'attachent uniquement aux politiques enfants et ne sont pas héritées. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/notifications/notification-policies/ et https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/configure-notifications/mute-timings/
- Cloud n'a pas de provisionnement par fichier. Le provisionnement de l'arbre de politiques remplace toutes les politiques. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/set-up/provision-alerting-resources/ et https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/set-up/provision-alerting-resources/export-alerting-resources/
Synthetic Monitoring
- Chaque sonde sélectionnée atteint la cible à chaque intervalle, presque simultanément. https://grafana.com/docs/grafana-cloud/observe-and-act/testing/synthetic-monitoring/introduction/
- MultiHTTP ne valide pas automatiquement un statut 200. Définissez des assertions pour chaque requête. https://grafana.com/docs/grafana-cloud/observe-and-act/testing/synthetic-monitoring/create-checks/checks/multihttp/
Tableaux de bord
- L'API des tableaux de bord les adresse par
metadata.name(l'uid), pas par le champmetadata.uid. L'espace de noms Cloud eststacks-<STACK_ID>. https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/dashboard/ et https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/apis/
Anciens modèles
Fichiers de référence
| Fichier | À lire pour |
|---|---|
| references/otlp-ingestion.md | Point de terminaison OTLP, renommage des métriques, target_info, erreurs d'ingestion, logs OTLP |
| references/traces-and-traceql.md | Limites des traces, échantillonnage, générateur de métriques, exemplaires, TraceQL |
| references/metrics-promql-and-cardinality.md | Coût PromQL, API de labels, facturation, limites, métriques adaptatives |
| references/logs-and-logql.md | Ordre LogQL, analyseurs, limites Cloud Logs, facturation |
| references/alert-rules.md | Types de règles, états, « Aucune donnée » et « Erreur », labels, règles d'enregistrement |
| references/notifications-and-alerting-provisioning.md | Points de contact, politiques, plages de silence, modèles, provisionnement |
| references/synthetic-monitoring.md | Types de vérifications, MultiHTTP, vérifications k6, sondes, disponibilité, alertes |
| references/dashboards-and-as-code.md | Variables, modèle JSON, API des tableaux de bord, Terraform, Foundation SDK |
| references/access-tokens-and-apis.md | Politiques d'accès, scopes, comptes de service, chemins /apis |
Les sources et les détails de lecture sont listés dans SOURCES.md.