Dela via


Skapa och hantera Grafana API-nycklar i Azure Managed Grafana (inaktuell)

Viktigt!

Det här dokumentet är inaktuellt eftersom funktionen API-nycklar har ersatts av tjänstkonton i Grafana 9.1. Om du vill växla till att använda tjänstkonton går du till Konfigurations-API-nycklar > i Grafana-instanser som skapades före lanseringen av Grafana 9.1 och väljer Migrera till tjänstkonton nu. Välj Ja, migrera nu. Varje befintlig API-nycklar migreras automatiskt till ett tjänstkonto med en token. Tjänstkontot skapas med samma behörighet som API-nyckeln och de aktuella API-nycklarna fortsätter att fungera som tidigare.

Varning

Varje API-nyckel behandlas av Azure Managed Grafana som en enda aktiv användare. Om du genererar nya API-nycklar ökar därför din månatliga Azure-faktura. Priser per aktiv användare finns i Prisinformation.

I den här guiden får du lära dig hur du genererar och hanterar API-nycklar och börjar göra API-anrop till Grafana-servern. Med Grafana API-nycklar kan du skapa integreringar mellan Azure Managed Grafana och andra tjänster.

Förutsättningar

Aktivera API-nycklar

API-nycklar är inaktiverade som standard i Azure Managed Grafana. Du kan aktivera den här funktionen när instansen skapas i Azure-portalen, eller så kan du aktivera den på en befintlig instans med hjälp av Azure-portalen eller CLI.

Skapa en Azure Managed Grafana-arbetsyta med API-nyckelskapande aktiverat

När du skapar Azure Managed Grafana-arbetsytan aktiverar du skapandet av API-nycklar på fliken Avancerat genom att ange Aktivera skapande av API-nyckel till Aktiverad. Mer information om hur du skapar en ny instans med hjälp av Azure-portalen finns i Snabbstart: Skapa en Azure Managed Grafana-instans.

Aktivera skapande av API-nyckel på en befintlig Azure Managed Grafana-instans

  1. I Azure-portalen går du till Inställningar och väljer Konfiguration och sedan Aktivera under API-nycklar.

    Screenshot of the Azure platform. Enable API keys.

  2. Välj Spara för att bekräfta att du vill aktivera skapandet av API-nycklar i Azure Managed Grafana.

Generera en API-nyckel

  1. Öppna din Azure Managed Grafana-instans och välj Konfigurations-API-nycklar> på den vänstra menyn. Screenshot of the Grafana dashboard. Access API keys page.

  2. Välj Ny API-nyckel.

  3. Fyll i formuläret och välj Lägg till för att generera den nya API-nyckeln.

    Parameter Beskrivning Exempel
    Nyckelnamn Ange ett namn för din nya Grafana API-nyckel. api-key-1
    Hanterad Grafana-roll Välj en hanterad Grafana-roll: Viewer, Editor eller Admin. Editor
    Time to live Ange en tid innan API-nyckeln upphör att gälla. Använd s för sekunder, m för minuter, h för timmar, d för dagar, w i veckor, M för månader, y i flera år. 7 d

    Screenshot of the Grafana dashboard. API creation form is filled out.

  4. När nyckeln har genererats visas ett meddelande med den nya nyckeln och ett curl-kommando, inklusive din nyckel. Kopiera den här informationen och spara den i dina poster nu, eftersom den kommer att döljas när du lämnar den här sidan. Om du stänger den här sidan utan att spara den nya API-nyckeln måste du generera en ny.

    Screenshot of the Grafana dashboard. API key is displayed.

Du kan nu använda den här Grafana API-nyckeln för att anropa Grafana-servern.

Testa API-nyckeln

Kör kommandot az grafana dashboard list nedan för att kontrollera om DIN API-nyckel fungerar. Ersätt platshållarna <azure-managed-grafana-name> och <api-key> med namnet på din Azure Managed Grafana-instans och din API-nyckel.

az grafana dashboard list --name <azure-managed-grafana-name> --api-key <api-key>

Terminalens utdata visar alla instrumentpaneler som din API-nyckel kan komma åt i den angivna Azure Managed Grafana-instansen.

Hantera API-nycklar

Befintliga API-nycklar visas i Konfigurations-API-nycklar>. Som standard visas endast aktiva API-nycklar. Välj Inkludera utgångna nycklar för att visa alla skapade nycklar och välj X (Ta bort) för att ta bort API-nyckeln.

Screenshot of the Grafana dashboard. API keys are listed under Configuration > API keys.

Nästa steg

I den här guiden har du lärt dig hur du skapar en API-nyckel för Azure Managed Grafana. När du är klar börjar du använda tjänstkonton som det nya sättet att autentisera program som interagerar med Grafana: