Grafana Cloud a partir da documentação oficial
Versão coberta: O Grafana Cloud é lançado continuamente sem seletor de versão. As páginas OSS (Grafana, Mimir, Loki, Tempo) são lidas na versão mais recente.
Cada afirmação traz sua URL de documentação. Leia o guia de início rápido e, em seguida, uma referência correspondente. Consulte "Padrões antigos" para configurações antigas.
Início rápido
Credenciais
- Tokens de política de acesso abrem telemetria e a API do Cloud, nunca a API HTTP da instância. Painéis, pastas, usuários e fontes de dados precisam de um token de conta de serviço. Tokens de conta de serviço e tokens de política de acesso da API do Cloud vão em
Authorization: Bearer <TOKEN>. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/access-policies/ e https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/authentication/ - Nenhum tipo de token expira por padrão. Defina uma expiração, uma política por tarefa. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/access-policies/create-access-policies/ e https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/service-accounts/
- Autenticação básica de telemetria: user = ID da instância numérico, password = token de política de acesso com o escopo
*:writeou*:readcorreto. https://grafana.com/docs/grafana-cloud/send-data/traces/set-up/verify-ingestion/
Ingestão OTLP
- Copie o endpoint OTLP do tile OpenTelemetry da stack. Regiões criadas antes de 15/01/2026 usam nomes de host planos, posteriores usam aninhados, portanto nunca o construa a partir de um modelo. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/account-management/region-url-formats/
- As variáveis
OTEL_EXPORTER_OTLP_*_ENDPOINTespecíficas de sinal precisam do caminho completo/otlp/v1/<signal>. A variável base recebe o caminho anexado. https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/ - Nomes de métricas recebem
_para pontos e sufixos de unidade ou_total. Atributos de recurso vão paratarget_info, unidos porjobeinstance. https://grafana.com/docs/grafana-cloud/send-data/otlp/otlp-format-considerations/
Consultas
- PromQL: sempre
[$__rate_interval]e defina o intervalo de coleta da fonte de dados para o real (padrão15s). Variáveis com múltiplos valores precisam de=~. https://grafana.com/docs/grafana/latest/datasources/prometheus/template-variables/ - APIs de rótulos do Mimir: sempre passe
starteend. https://grafana.com/docs/mimir/latest/query/query-metric-labels/ - LogQL: seletor, depois filtros de linha, depois parsers.
{app=~".*"}é rejeitado, use.+. Filtre__error__ = ""antes deunwrap. https://grafana.com/docs/loki/latest/query/bp-query/, https://grafana.com/docs/loki/latest/query/troubleshoot-query/ e https://grafana.com/docs/loki/latest/query/query_examples/ - TraceQL: condições em um único
{}se aplicam a um span. Escopo todos os atributos. Prefira&&, pois||é mais lento.durationsem escopo é a duração do span. https://grafana.com/docs/tempo/latest/traceql/construct-traceql-queries/ e https://grafana.com/docs/tempo/latest/traceql/tune-traceql-queries/
Custo e limites
- Reduzir o intervalo de coleta pela metade dobra os pontos de dados por minuto por série, e o Pro inclui 1 DPM por série, então o restante custa extra.
sum(foo)lê tantas amostras quantofoo. https://grafana.com/docs/grafana-cloud/platform/pricing-and-usage/metrics/ - Streams do Loki têm no máximo 15 rótulos por padrão. Coloque IDs em metadados estruturados. https://grafana.com/docs/grafana-cloud/send-data/logs/loki-limits/
Alertas
- Regras gerenciadas pelo Grafana por padrão. Estados Sem Dados e Erro disparam alertas
DatasourceNoData/DatasourceErrorseparados com seus próprios rótulos, portanto silêncios, intervalos de silêncio e políticas do alerta original podem não se aplicar a eles. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/alert-rule-evaluation/nodata-and-error-states/ - Apenas rótulos roteiam. Um valor em uma anotação cai na política padrão. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/alert-rules/annotation-label/
- Irmãos param na primeira política correspondente, a menos que "Continuar correspondendo irmãos" esteja ativado. Os intervalos de silêncio são anexados apenas a políticas filhas e não são herdados. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/notifications/notification-policies/ e https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/configure-notifications/mute-timings/
- O Cloud não possui provisionamento de arquivos. Provisionar a árvore de políticas sobrescreve todas as políticas. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/set-up/provision-alerting-resources/ e https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/set-up/provision-alerting-resources/export-alerting-resources/
Synthetic Monitoring
- Cada probe selecionado atinge o destino em cada intervalo, quase ao mesmo tempo. https://grafana.com/docs/grafana-cloud/observe-and-act/testing/synthetic-monitoring/introduction/
- MultiHTTP não valida um status 200 automaticamente. Defina asserções para cada requisição. https://grafana.com/docs/grafana-cloud/observe-and-act/testing/synthetic-monitoring/create-checks/checks/multihttp/
Painéis
- A API de painéis endereça painéis por
metadata.name(o uid), não pelo campometadata.uid. O namespace do Cloud éstacks-<STACK_ID>. https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/dashboard/ e https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/apis/
Padrões antigos
Arquivos de referência
| Arquivo | Leia para |
|---|---|
| references/otlp-ingestion.md | Endpoint OTLP, renomeação de métricas, target_info, erros de ingestão, logs OTLP |
| references/traces-and-traceql.md | Limites de rastreamento, amostragem, metrics-generator, exemplares, TraceQL |
| references/metrics-promql-and-cardinality.md | Custo de PromQL, APIs de rótulos, faturamento, limites, Adaptive Metrics |
| references/logs-and-logql.md | Ordem do LogQL, parsers, limites do Cloud Logs, faturamento |
| references/alert-rules.md | Tipos de regra, estados, Sem Dados e Erro, rótulos, regras de gravação |
| references/notifications-and-alerting-provisioning.md | Pontos de contato, políticas, intervalos de silêncio, modelos, provisionamento |
| references/synthetic-monitoring.md | Tipos de verificação, MultiHTTP, verificações k6, probes, disponibilidade, alertas |
| references/dashboards-and-as-code.md | Variáveis, modelo JSON, API de painéis, Terraform, Foundation SDK |
| references/access-tokens-and-apis.md | Políticas de acesso, escopos, contas de serviço, caminhos /apis |
Fontes e detalhes de leitura estão listados em SOURCES.md.