Connect to Grafana

Overview

Finout's Grafana Cloud integration ingests cost and usage data via Grafana's FOCUS-standardized API, and makes it available in MegaBill alongside your other cloud and SaaS services, for a unified view.

With this integration, you can:

• Connect one or more Grafana Cloud organizations

• Break down costs by service (Metrics, Logs, Traces, Profiles, and more), service category and resource name.

• Include Grafana Cloud cost and usage data in custom dashboards, set up alerts to track anomalies, and incorporate it into your financial plans

Finout uses read-only access to the Grafana Cloud FOCUS API. It does not perform actions that can create, modify, or incur costs.

Before you start

Connecting Grafana Cloud requires a Cloud Access Policy token scoped to org-billing-focus:read.

Prerequisite: You must have the Admin role within the Grafana Cloud Portal to create an access policy and token at the organization level.

Generate a Grafana API token

1. Sign in to Grafana Cloud and select your organization from the drop-down at the top of the page.

2. Locate Security in the left-hand navigation and select Access Policies.

3. Select Create access policy.

4. Enter a Display Name for the access policy.

5. From the Realm drop-down, select your organization (so the policy applies across all stacks).

6. Under Scopes, select org-billing-focus:read.

7. Select Create to add the access policy.

8. Choose the access policy you just created, then select Add token to open the Create new token dialog.

9. Enter a Display name for the token, and optionally an expiration date.

10. Select Create, then Copy to clipboard to copy the generated token — you'll need it in Finout in the next step.

The token is only shown once. Copy and save it in a safe place before continuing.

2. Integrate Grafana Cloud with Finout

1. In Finout, navigate to Settings > Cost Centers.

2. Under Grafana Cloud, click Connect.

1. Fill in the following fields:

   1. Cost Center Name — pre-filled with "Grafana Cloud"; you can edit this if you'd like a different display name.

   2. Grafana Org Name — your Grafana org slug (for example, mycompany), found in your Grafana Cloud URL.

   3. Grafana API Token — the token generated in step 1.

2. Click Complete Setup.

Finout validates the connection immediately by querying Grafana API with the values you entered. If the token or org name is invalid, or the token doesn't have the org-billing-focus:read scope, you'll see an error before the Cost Center is created.

Your Cost Center is created, and data becomes available in Finout within 24 hours.

FAQ

How far back can Finout backfill Grafana Cloud cost data?

Up to 60 days upon setup. Grafana’s FOCUS API provides a fixed trailing 60-day window of cost data and does not support backfilling beyond that timeframe.