---
title: "Work with your resources | Grafana documentation"
description: "Grafana and Grafana Cloud resources you can manage with gcx, and the commands to use for each."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/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](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/#declarative-resource-workflows): Manage resources as JSON or YAML files with a single set of commands.
- [Product-specific commands](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/#product-specific-commands): Use dedicated commands for each Grafana area or Grafana Cloud product.

You can also [query your telemetry](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/#query-telemetry), such as metrics, logs, traces, and profiles, from the command line.

> Note
> 
> For the Grafana roles, RBAC actions, and Grafana Cloud access policy scopes each area requires, refer to [Roles and permissions](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/permissions/).

## Declarative resource workflows

Use [`gcx resources`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#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`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-resources-list-types). To view example manifests, run [`gcx resources list-examples`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-resources-list-examples).

For step-by-step workflows, refer to [Resource management workflows](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/manage-resources/).

## 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](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/) or run the command with `--help`.

Expand table

AreaWhat you can manageCommandGuides

**Adaptive Telemetry**Rules, policies, and recommendations for Adaptive Metrics, Logs, Traces, and Profiles, and log archiving (experimental)[`gcx metrics adaptive`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-metrics-adaptive), [`gcx logs adaptive`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-logs-adaptive), [`gcx logs archive`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-logs-archive), [`gcx traces adaptive`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-traces-adaptive), [`gcx profiles adaptive`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-profiles-adaptive)

**Agent Observability**AI agents, conversations, evaluations, model cards, and prompt templates[`gcx agento11y`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-agento11y)

**Alerting**Alert rules, contact points, notification policies, and related alerting configuration[`gcx alert`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-alert), [`gcx resources`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-resources)

- [Lint resources](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/lint-resources/)
- [Use gcx to manage alerting resources](https://grafana.com/docs/grafana/next/alerting/set-up/provision-alerting-resources/gcx-provisioning/)

**Annotations**Annotations on dashboards and panels, organization-wide annotations, and annotation tags[`gcx annotations`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-annotations)

**Application Observability**Monitored services and their settings[`gcx appo11y`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-appo11y)

**Dashboards**Dashboards, their version history, and rendered snapshots[`gcx dashboards`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-dashboards), [`gcx resources`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-resources)

- [Dashboards as code](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/dashboards-as-code/)
- [Lint resources](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/lint-resources/)

**Data sources**Data source configurations and health checks[`gcx datasources`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-datasources)

**Database Observability**Monitored database instances[`gcx dbo11y`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-dbo11y)

**Fleet Management**Collectors and configuration pipelines[`gcx fleet`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-fleet)

**Folders**Folders[`gcx resources`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-resources)

**Frontend Observability**Frontend apps, source maps, and user sessions[`gcx frontend`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-frontend)

**Grafana Assistant**Conversations, investigations, MCP servers, and Assistant Watchers[`gcx assistant`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-assistant)

- [Manage Assistant Watchers](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/manage-assistant-watchers/)
- [Check Assistant usage and limits](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/guides/assistant-usage/)

**Grafana Cloud platform**Organization memberships and Grafana Cloud stacks[`gcx cloud`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-cloud)

**Instrumentation**Kubernetes clusters, cluster apps, and monitored services[`gcx instrumentation`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-instrumentation)

**IRM Incidents**Incidents and post-incident reviews[`gcx irm incidents`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-irm-incidents), [`gcx resources`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-resources)[Incident descriptions](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/manage-resources/#incident-descriptions)

**IRM OnCall**Schedules, escalation chains, integrations, and other OnCall configuration[`gcx irm oncall`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-irm-oncall)[Manage OnCall notification rules](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/manage-oncall-notification-rules/)

**Knowledge Graph**Entities, relationships, and the rules that shape them[`gcx kg`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-kg)

**Machine Learning**Forecasts, holidays, outlier detectors, and their alerts[`gcx ml`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-ml), [`gcx resources`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-resources)

- [Use gcx to manage Machine Learning resources](https://grafana.com/docs/grafana-cloud/ai-tools/machine-learning/additional-configuration/gcx/)
- [Manage Machine Learning resources as code](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/resources/manage-machine-learning/)

**Performance Testing (k6)**Projects, load tests, schedules, and test runs[`gcx k6`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-k6)

**SLOs**SLO definitions and reports[`gcx slo`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-slo), [`gcx resources`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-resources)[Use gcx to manage SLO resources](https://grafana.com/docs/grafana-cloud/observe-and-act/alert-and-measure-reliability/slo/set-up/gcx/)

**Synthetic Monitoring**Checks, probes, and saved queries[`gcx synthetic-monitoring`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-synthetic-monitoring), [`gcx resources`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-resources)

## Query telemetry

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

Expand table

| Signal       | Command                                                                                                      | Guides                                                                                                      |
|--------------|--------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------|
| **Metrics**  | [`gcx metrics`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-metrics)   |                                                                                                             |
| **Logs**     | [`gcx logs`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-logs)         |                                                                                                             |
| **Traces**   | [`gcx traces`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-traces)     |                                                                                                             |
| **Profiles** | [`gcx profiles`](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/cli-reference/#gcx-profiles) | [Compare profiles](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/guides/compare-profiles/) |

To continue in Grafana, add `--share-link` or `--open` to a query command to print or open the query in Explore. On the `query` commands and `gcx profiles diff`, add `--drilldown-link` or `--open-drilldown` to use the matching Drilldown app instead; the `metrics` commands have no Drilldown equivalent. If Drilldown can’t show the query, `gcx` uses the Explore link.

To investigate an empty dashboard or missing application telemetry, refer to [Diagnose missing telemetry](https://grafana.com/docs/grafana/next/ai-tools/grafana-cli/gcx/guides/diagnose-missing-telemetry/).
