Overview

Torii integrates with Grafana and syncs:

• Users and their roles (Admin, Editor, Viewer)
• User status
• Last visit time for license usage tracking

This integration supports multiple Grafana accounts.

For more information about integration capabilities, see Integration Capabilities.

Requirements

Accounts & Permissions

• A Grafana account
• Organization Administrator access to create service accounts and tokens
• The service account must have Admin role

Required keys

• Grafana Instance URL: Your Grafana instance base URL (e.g., https://your-instance.grafana.net)
• API Token: Service account token with Organization Administrator permissions

How to Generate the Required Values

Step 1: Create a Service Account

1. Log in to your Grafana instance
2. Navigate to Administration → Users and access → Service Accounts (or Configuration → Service Accounts)
3. Click Add service account
4. Configure the service account:
   • Name: "Torii Integration" (or any descriptive name)
   • Role: Admin
5. Click Create

Step 2: Generate a Service Account Token

1. After creating the service account, click Add service account token
2. Configure the token:
   • Name: "Torii API Token" (or any descriptive name)
   • Time to live: Set expiration or leave blank for no expiration
3. Click Generate token
4. Copy the token immediately — it's only shown once

Step 3: Note Your Grafana Instance URL

Record your Grafana instance base URL. Example: https://your-instance.grafana.net

How to Connect the Integration

1. Go to the Integrations page in Torii
2. Search for Grafana and click Connect
3. Enter the required values:
   • Grafana Instance URL: Your Grafana instance base URL
   • API Token: The service account token you generated
4. Click Connect

Important Notes

• This integration syncs users within your organization only (not all users globally)
• The integration supports multiple accounts — each Grafana instance is treated as a separate account

Q&A

Q: What permissions does the service account token need?

A: The service account must have Admin role. This is required to access the /api/org/users endpoint which lists all users in your organization.

For any further questions, please contact Torii Support.