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
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.
-
Run the following command to port forward your Grafana service:
$ kubectl port-forward svc/grafana -n <my-namespace> 8900:80
-
Navigate to localhost:8900. You should see a login page similar to the following:
-
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
%.
-
Use the returned value as your password when logging in to Grafana. Now you can log in to Grafana with the following credentials:
| Field | Value |
|---|
| Username | admin |
| Password | <my-secret> |
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.
The following HTTP header values are required to connect to CoreWeave’s data sources, where <MY-TOKEN> is your CoreWeave API Access Token.
| Field | Value |
|---|
| Header | Authorization |
| Value | Bearer <MY-TOKEN> |
Next, navigate to the Authentication section. This is the only section that requires editing.
Then, click the dropdown arrow on the right-hand side of the HTTP headers subsection to display the + Add header button.
In the Header field, enter Authorization.
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:
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:
