Grafana Cloud desde la documentación oficial
Versión cubierta: Grafana Cloud se lanza continuamente sin selector de versión. Las páginas OSS (Grafana, Mimir, Loki, Tempo) se leen en su última versión.
Cada afirmación lleva su URL de documentación. Lea la guía de inicio rápido, luego una referencia coincidente. Consulte "Patrones antiguos" para configuraciones obsoletas.
Inicio rápido
Credenciales
- Los tokens de política de acceso abren telemetría y la API de Cloud, nunca la API HTTP de la instancia. Los paneles, carpetas, usuarios y fuentes de datos necesitan un token de cuenta de servicio. Los tokens de cuenta de servicio y los tokens de política de acceso de la API de Cloud van en
Authorization: Bearer <TOKEN>. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/access-policies/ y https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/authentication/ - Ningún tipo de token caduca por defecto. Establezca una caducidad, una política por tarea. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/access-policies/create-access-policies/ y https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/security-and-access/authentication-and-permissions/service-accounts/
- Autenticación básica de telemetría: usuario = ID de instancia numérico, contraseña = token de política de acceso con el alcance
*:writeo*:readcorrecto. https://grafana.com/docs/grafana-cloud/send-data/traces/set-up/verify-ingestion/
Ingesta OTLP
- Copie el endpoint OTLP desde el mosaico de OpenTelemetry del stack. Las regiones creadas antes del 15 de enero de 2026 usan nombres de host planos, las posteriores anidados, así que nunca lo construya a partir de una plantilla. https://grafana.com/docs/grafana-cloud/platform/security-and-account-management/account-management/region-url-formats/
- Las variables
OTEL_EXPORTER_OTLP_*_ENDPOINTespecíficas de señal necesitan la ruta completa/otlp/v1/<señal>. La variable base la añade automáticamente. https://grafana.com/docs/grafana-cloud/send-data/otlp/send-data-otlp/ - Los nombres de métricas obtienen
_para puntos y unidad o sufijos_total. Los atributos de recurso van atarget_info, unidos porjobeinstance. https://grafana.com/docs/grafana-cloud/send-data/otlp/otlp-format-considerations/
Consultas
- PromQL: siempre
[$__rate_interval]y establezca el intervalo de recopilación de la fuente de datos al real (por defecto15s). Las variables multivalor necesitan=~. https://grafana.com/docs/grafana/latest/datasources/prometheus/template-variables/ - APIs de etiquetas de Mimir: siempre pase
startyend. https://grafana.com/docs/mimir/latest/query/query-metric-labels/ - LogQL: selector, luego filtros de línea, luego analizadores.
{app=~".*"}es rechazado, use.+. Filtre__error__ = ""antes deunwrap. https://grafana.com/docs/loki/latest/query/bp-query/, https://grafana.com/docs/loki/latest/query/troubleshoot-query/ y https://grafana.com/docs/loki/latest/query/query_examples/ - TraceQL: las condiciones en un solo
{}se aplican a un solo span. Especifique el alcance de cada atributo. Prefiera&&, ya que||es más lento.durationsin alcance es la del span. https://grafana.com/docs/tempo/latest/traceql/construct-traceql-queries/ y https://grafana.com/docs/tempo/latest/traceql/tune-traceql-queries/
Costos y límites
- Reducir a la mitad el intervalo de recopilación duplica los puntos de datos por minuto por serie, y Pro incluye 1 DPM por serie, por lo que el resto cuesta extra.
sum(foo)lee tantas muestras comofoo. https://grafana.com/docs/grafana-cloud/platform/pricing-and-usage/metrics/ - Los streams de Loki tienen como máximo 15 etiquetas por defecto. Coloque los IDs en metadatos estructurados. https://grafana.com/docs/grafana-cloud/send-data/logs/loki-limits/
Alertas
- Reglas gestionadas por Grafana por defecto. Los estados "Sin datos" y "Error" activan alertas
DatasourceNoData/DatasourceErrorseparadas con sus propias etiquetas, por lo que los silencios, horarios de silencio y políticas de la alerta original pueden no aplicarse a ellas. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/alert-rule-evaluation/nodata-and-error-states/ - Solo las etiquetas enrutan. Un valor en una anotación cae en la política predeterminada. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/alert-rules/annotation-label/
- Los hermanos se detienen en la primera política coincidente a menos que "Continuar coincidiendo con hermanos" esté activado. Los horarios de silencio se adjuntan solo a políticas hijas y no se heredan. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/fundamentals/notifications/notification-policies/ y https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/configure-notifications/mute-timings/
- Cloud no tiene aprovisionamiento de archivos. El aprovisionamiento del árbol de políticas sobrescribe todas las políticas. https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/alerting/set-up/provision-alerting-resources/ y 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 sonda seleccionada golpea el objetivo en cada intervalo, casi al mismo tiempo. https://grafana.com/docs/grafana-cloud/observe-and-act/testing/synthetic-monitoring/introduction/
- MultiHTTP no valida un estado 200 automáticamente. Defina aserciones para cada solicitud. https://grafana.com/docs/grafana-cloud/observe-and-act/testing/synthetic-monitoring/create-checks/checks/multihttp/
Paneles
- La API de paneles direcciona los paneles por
metadata.name(el uid), no por el campometadata.uid. El espacio de nombres de Cloud esstacks-<STACK_ID>. https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/dashboard/ y https://grafana.com/docs/grafana-cloud/learn-and-build/developer-resources/api-reference/http-api/apis/
Patrones antiguos
Archivos de referencia
| Archivo | Léalo para |
|---|---|
| references/otlp-ingestion.md | Endpoint OTLP, renombrado de métricas, target_info, errores de ingesta, logs OTLP |
| references/traces-and-traceql.md | Límites de trazas, muestreo, generador de métricas, ejemplares, TraceQL |
| references/metrics-promql-and-cardinality.md | Costo de PromQL, APIs de etiquetas, facturación, límites, Adaptive Metrics |
| references/logs-and-logql.md | Orden de LogQL, analizadores, límites de Cloud Logs, facturación |
| references/alert-rules.md | Tipos de reglas, estados, Sin datos y Error, etiquetas, reglas de grabación |
| references/notifications-and-alerting-provisioning.md | Puntos de contacto, políticas, horarios de silencio, plantillas, aprovisionamiento |
| references/synthetic-monitoring.md | Tipos de comprobación, MultiHTTP, comprobaciones k6, sondas, tiempo de actividad, alertas |
| references/dashboards-and-as-code.md | Variables, modelo JSON, API de paneles, Terraform, Foundation SDK |
| references/access-tokens-and-apis.md | Políticas de acceso, alcances, cuentas de servicio, rutas /apis |
Las fuentes y los detalles de lectura se enumeran en SOURCES.md.