Create access token to onboard collector to Grafana Fleet Management

If your Grafana Alloy collector isn’t shown on the Fleet Management page, you can manually register it.

In this milestone, you’ll generate an access token that registers your collector with Fleet Management. In the next milestone, you’ll add this token as the password in your Alloy configuration file.

To create an access token, complete the following steps:

  1. In your Grafana Cloud instance, navigate to Connections > Collector > Configure.

  2. Use the tool on this page to create a new token. Give the token a name and click the Create token button. You don’t need to complete the rest of the installation instructions if you’re not installing a new Alloy instance. The generated token comes with the predefined scope set:alloy-data-write, which includes scopes for reading remote configurations in Fleet Management and writing telemetry to Grafana Cloud databases. You can see the defined scopes by hovering over set:alloy-data-write:

    One section of the Alloy installation workflow in the Fleet Management interface in Grafana Cloud where a cursor hovers over the `set:alloy-data-write` scope to show that this scope includes scopes for `metrics:write`, `logs:write`, `traces:write`, `profiles:write`, and `fleet-management:read`.
  3. Copy the token and save it in a secure password file. You’ll need the token for the next step, but you won’t be able to view it again once you leave the page.

For more information on creating access policies, refer to Grafana Cloud access policies.

Note

If you create a policy using a different workflow or if you’re modifying an existing access policy, make sure to add the following scopes:

  • fleet-management:read
  • metrics:write
  • logs:write

If you want to use a single token for all of your telemetry needs, add these scopes as well:

  • traces:write
  • profiles:write

In the next milestone, you’ll use the token you just created to register the collector with Fleet Management.

More to explore (optional)

At this point in your journey, you can explore the following paths:

Onboard collectors deployed in Kubernetes to Fleet Management

Grafana Cloud Access Policies

Create tokens for an access policy


page 4 of 9