This is documentation for the next version of Grafana documentation. For the latest stable release, go to the latest version.

Grafana Cloud Enterprise Open source

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:

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.

AreaWhat you can manageCommandGuides
DashboardsDashboards, their version history, and rendered snapshotsgcx dashboards, gcx resourcesDashboards as code, Lint resources
FoldersFoldersgcx resources
Data sourcesData source configurations and health checksgcx datasources
AlertingAlert rules, contact points, notification policies, and related alerting configurationgcx alert, gcx resourcesLint resources
SLOsSLO definitions and reportsgcx slo, gcx resources
IRM IncidentsIncidents and post-incident reviewsgcx irm incidents, gcx resourcesIncident descriptions
IRM OnCallSchedules, escalation chains, integrations, and other OnCall configurationgcx irm oncallManage OnCall notification rules
Machine LearningForecasts, holidays, outlier detectors, and their alertsgcx ml, gcx resourcesManage Machine Learning resources
Adaptive TelemetryRules, policies, and recommendations for Adaptive Metrics, Logs, Traces, and Profilesgcx metrics adaptive, gcx logs adaptive, gcx traces adaptive, gcx profiles adaptive
Synthetic MonitoringChecks, probes, and saved queriesgcx synthetic-monitoring, gcx resources
Performance Testing (k6)Projects, load tests, schedules, and test runsgcx k6
Fleet ManagementCollectors and configuration pipelinesgcx fleet
Frontend ObservabilityFrontend apps, source maps, and user sessionsgcx frontend
Application ObservabilityMonitored services and their settingsgcx appo11y
Database ObservabilityMonitored database instancesgcx dbo11y
InstrumentationKubernetes clusters, cluster apps, and monitored servicesgcx instrumentation
Grafana AssistantConversations, investigations, MCP servers, and Assistant Watchersgcx assistantManage Assistant Watchers, Check Assistant usage and limits
Agent ObservabilityAI agents, conversations, evaluations, and prompt templatesgcx agento11y
Knowledge GraphEntities, relationships, and the rules that shape themgcx kg
Grafana Cloud platformOrganization memberships and Grafana Cloud stacksgcx cloud

Query telemetry

Use the signal commands to query your data sources directly from the command line:

SignalCommandGuides
Metricsgcx metrics
Logsgcx logs
Tracesgcx traces
Profilesgcx profilesCompare profiles

To investigate an empty dashboard or missing application telemetry, refer to Diagnose missing telemetry.