Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/grafana-cloud/ai-tools/gcx/guides/available-resources.md, or by sending Accept: text/markdown to https://grafana.com/docs/grafana-cloud/ai-tools/gcx/guides/available-resources/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
Work with your resources
gcx lets you manage resources across Grafana and Grafana Cloud, from dashboards and alert rules to SLOs, on-call schedules, and synthetic checks.
You can work with resources in two ways:
- Declarative resource workflows: Manage resources as JSON or YAML files with a single set of commands.
- Product-specific commands: Use dedicated commands for each Grafana area or Grafana Cloud product.
You can also query your telemetry, such as metrics, logs, traces, and profiles, from the command line.
Declarative resource workflows
Use gcx resources to pull, push, inspect, edit, validate, and delete resources as JSON or YAML manifests. The same commands work for Grafana-native resources, such as dashboards, folders, alertrules, routingtrees, templategroups, and timeintervals, and for supported Grafana Cloud provider resources.
To find out which resource types your instance serves, run gcx resources list-types. To view example manifests, run gcx resources list-examples.
For step-by-step workflows, refer to Resource management workflows.
Product-specific commands
Each Grafana area and Grafana Cloud product also has its own commands to create, inspect, update, and operate its resources. Areas that also list gcx resources in the table support both ways of working.
The following table lists the main Grafana areas and Grafana Cloud products you can manage with gcx. For the complete list of commands, refer to the CLI reference or run the command with --help.
| Area | What you can manage | Command | Guides |
|---|---|---|---|
| Dashboards | Dashboards, their version history, and rendered snapshots | gcx dashboards, gcx resources | Dashboards as code, Lint resources |
| Folders | Folders | gcx resources | |
| Data sources | Data source configurations and health checks | gcx datasources | |
| Alerting | Alert rules, contact points, notification policies, and related alerting configuration | gcx alert, gcx resources | Lint resources |
| SLOs | SLO definitions and reports | gcx slo, gcx resources | |
| IRM Incidents | Incidents and post-incident reviews | gcx irm incidents, gcx resources | Incident descriptions |
| IRM OnCall | Schedules, escalation chains, integrations, and other OnCall configuration | gcx irm oncall | Manage OnCall notification rules |
| Machine Learning | Forecasts, holidays, outlier detectors, and their alerts | gcx ml, gcx resources | Manage Machine Learning resources |
| Adaptive Telemetry | Rules, policies, and recommendations for Adaptive Metrics, Logs, Traces, and Profiles | gcx metrics adaptive, gcx logs adaptive, gcx traces adaptive, gcx profiles adaptive | |
| Synthetic Monitoring | Checks, probes, and saved queries | gcx synthetic-monitoring, gcx resources | |
| Performance Testing (k6) | Projects, load tests, schedules, and test runs | gcx k6 | |
| Fleet Management | Collectors and configuration pipelines | gcx fleet | |
| Frontend Observability | Frontend apps, source maps, and user sessions | gcx frontend | |
| Application Observability | Monitored services and their settings | gcx appo11y | |
| Database Observability | Monitored database instances | gcx dbo11y | |
| Instrumentation | Kubernetes clusters, cluster apps, and monitored services | gcx instrumentation | |
| Grafana Assistant | Conversations, investigations, MCP servers, and Assistant Watchers | gcx assistant | Manage Assistant Watchers, Check Assistant usage and limits |
| Agent Observability | AI agents, conversations, evaluations, and prompt templates | gcx agento11y | |
| Knowledge Graph | Entities, relationships, and the rules that shape them | gcx kg | |
| Grafana Cloud platform | Organization memberships and Grafana Cloud stacks | gcx cloud |
Query telemetry
Use the signal commands to query your data sources directly from the command line:
| Signal | Command | Guides |
|---|---|---|
| Metrics | gcx metrics | |
| Logs | gcx logs | |
| Traces | gcx traces | |
| Profiles | gcx profiles | Compare profiles |
To investigate an empty dashboard or missing application telemetry, refer to Diagnose missing telemetry.
Was this page helpful?
Related resources from Grafana Labs


