Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt

Use this file to discover all available pages before exploring further.

If you need more customization and control than CoreWeave Grafana provides, you can deploy a self-hosted Grafana instance. With self-hosting, you can create new dashboards, export or edit CoreWeave Grafana dashboards, and freely explore all available metrics in your environment. Self-hosted Grafana instances are deployed via CoreWeave Charts. This handles most of the process of configuring Data Sources, however authentication requires some manual configuration.

Prerequisites

To set up a self-hosted Grafana instance, you will need:
Customers opting to self-host a Grafana instance are responsible for all setup, maintenance, and resource costs associated with hosting. Using CoreWeave Grafana is recommended.

Install Grafana with CoreWeave Charts

First, access the CoreWeave Charts repository with the following command:
helm repo add coreweave https://charts.core-services.ingress.coreweave.com
Next, install the grafana chart:
helm install -n <my-namespace> grafana coreweave/grafana
The grafana-dashboards chart is a dependency of grafana, so it does not need to be installed independently.

Log in to Grafana with admin credentials

Before logging into Grafana, you must port forward your Grafana service.
  1. Run the following command to port forward your Grafana service:
    $ kubectl port-forward svc/grafana -n <my-namespace> 8900:80
    
  2. Navigate to localhost:8900. You should see a login page similar to the following: Grafana login page.
  3. The admin password is required to log in to Grafana for the first time. This password is stored as a Kubernetes Secret. To obtain the Secret value, run the following command, replacing <my-namespace> with your namespace ID:
    $ kubectl get secret grafana -n <my-namespace> -o=jsonpath='{.data.admin-password}' | base64 --decode
    
    Note: If using a Mac, you might need to remove the trailing %.
  4. Use the returned value as your password when logging in to Grafana. Now you can log in to Grafana with the following credentials:
    FieldValue
    Usernameadmin
    Password<my-secret>

Configure CoreWeave Metrics data source credentials

After logging in to Grafana with your admin credentials, you must configure credentials for the CoreWeave-provided Data Sources. First, configure the CoreWeave Metrics data source.

Configure the data source HTTP headers

The following HTTP header values are required to connect to CoreWeave’s data sources, where <MY-TOKEN> is your CoreWeave API Access Token.
FieldValue
HeaderAuthorization
ValueBearer <MY-TOKEN>
To configure these headers, navigate to Connections from Grafana’s left-hand menu to display the dropdown options. Then, click Data sources to proceed to the Data sources page. Select CoreWeave Metrics from the options listed to proceed to the Settings menu for the new data source. Grafana menu with data sources item indicated Next, navigate to the Authentication section. This is the only section that requires editing. Authentication section of Grafana data sources screen Then, click the dropdown arrow on the right-hand side of the HTTP headers subsection to display the + Add header button. HTTP headers section of Grafana data sources screen In the Header field, enter Authorization. Custom header section of Grafana data sources screen In the Value field, provide the value Bearer <MY-TOKEN>, where <MY-TOKEN> is your CoreWeave API Access Token. Configure the HTTP method to use GET by changing the HTTP dropdown method in the Other subsection to GET: Configure the HTTP method to use GET.

Configure the CoreWeave Logs data source

Once the configuration for the CoreWeave Metrics data source is complete, repeat the steps above for the CoreWeave Logs Data Source.

Learn more

For more information, explore the following resources:
Last modified on April 20, 2026