GraphQL-overvågningsdashboard og logføring (prøveversion)

Når du har installeret en API til GraphQL i Fabric, kan det være en god idé at forstå, hvordan API'en bruges af klienter, og foretage fejlfinding af fejl, hvis der er problemer med API'en. Brug Fabric GraphQL-overvågningsdashboardet til at visualisere, overvåge og foretage fejlfinding af din GraphQL API-anmodningsaktivitet. Denne funktion er i øjeblikket en prøveversion. I denne artikel forklares det, hvordan du aktiverer overvågning og brug af dashboardets komponenter effektivt.

Forudsætninger

• Overvågning af arbejdsområder er aktiveret . Du kan finde flere oplysninger under Oversigt over overvågning af arbejdsområder og følge trinnene for at aktivere overvågning af arbejdsområder.
• Før du begynder at bruge overvågnings- og logføringsfunktionerne, skal du have en API til GraphQL i Fabric. Du kan få flere oplysninger i Opret en API til GraphQL i Fabric og tilføje data.

Aktivering af GraphQL API-overvågning

I dette afsnit gennemgår vi de trin, der er nødvendige for at aktivere overvågning af din API til GraphQL. Denne funktion er som standard slået fra.

1. Hvis du vil aktivere målepunkter og/eller logføring oplevelse for hver API til GraphQL i din lejer, skal du åbne din GraphQL-API og derefter vælge ikonet Indstillinger:

   

2. I vinduet API-indstillinger skal du vælge indstillingen Overvågning (prøveversion) i menuen til venstre. Hvis overvågning af arbejdsområder ikke allerede er aktiveret, får du vist en note, der guider dig til at gå til indstillingerne for arbejdsområde for at aktivere den.

   

3. Når du har aktiveret overvågning for arbejdsområdet, kan du se indstillingerne for kun at aktivere Metrics (API-dashboard), Kun logføring (API-anmodninger) eller begge dele. Målepunkterne og loggene gemmes for at adskille tabeller i Kusto, og du kan aktivere hver funktion separat afhængigt af dit krav. Begge indstillinger er som standard deaktiveret:

   

API-anmodningsaktivitet

Når overvågning er aktiveret, aktiveres indstillingen API-anmodningsaktivitet på det øverste bånd fra GraphQL-API'en. Vælg den for at få adgang til overvågningsdetaljer.

API-anmodningsaktivitet består af to primære visninger:

1. API-dashboard (til målepunkter): På denne side vises alle tællere og grafer for det angivne tidsinterval.
2. API-anmodninger (for logføring): På denne side vises API-anmodninger inden for det angivne tidsinterval.

I de følgende afsnit beskriver vi funktionaliteten af hver indstilling.

Målepunkter (API-dashboard)

API-dashboardet indeholder en oversigt over API-aktivitet for dig med forskellige målepunkter og visualiseringer. Vælg fanen API-dashboard for at få adgang siden API-anmodningsaktivitet. Du kan nu hurtigt få vist følgende parametre for et bestemt tidsinterval:

• Samlet GraphQL API-tilstandsindeks, der indeholder:

  • API-anmodning pr. sekund
  • Succesrate
  • Tilstandsstatus

• Antal API-anmodninger

• Latency

• Antal anmodninger i liggende søjlediagram, der illustrerer antallet af vellykkede og fejl

Når du holder markøren over grafen, kan du se de detaljerede oplysninger om et bestemt datapunkt i et værktøjstip.

nøglefunktioner i målepunkter:

• valg af tidsinterval: Du kan vælge forskellige tidsintervaller for de data, der vises i overvågningsgraferne. Bemærk, at dataopbevaring kun er tilgængelig i 30 dagepga. overvågning af arbejdsområder grænser.

  

• API-anmodning pr. sekund: Du kan få vist antallet af API-anmodninger, der foretages hvert sekund i det valgte tidsinterval.

  

• succesrate: Du kan få vist succesfrekvensen, som er antallet af vellykkede anmodninger i forhold til det samlede antal anmodninger i det valgte tidsinterval.

  

• Samlet GraphQL API-tilstandsindeks baseret på succesrate pr. API:

  • Grøn: 75-100% af anmodninger er vellykkede (i orden)

  • Gul: 50-74% af anmodninger lykkes (kræver opmærksomhed)

  • Rød: Bælge 50% vellykkede anmodninger (usund)

    

• Samlet antal API-anmodninger: Du kan få vist det samlede antal API-anmodninger i det valgte tidsinterval.

• ventetid kurvediagram: Hvis du holder musen over grafer, kan du se ventetiden og datoen for hvert datapunkt.

  

• Antal anmodninger liggende søjlediagram, hvor der skelnes mellem vellykkede anmodninger og fejl: Hvis du holder markøren over grafer, kan du se dato og antal vellykkede og fejl for hvert datapunkt.

  

Når du ser unormal funktionsmåde på dashboardet, der kræver din opmærksomhed, kan du undersøge det yderligere ved at undersøge loggene for at identificere potentielle problemer og finde ud af, hvilke anmodninger der mislykkedes og har højere ventetid, og begynde at undersøge logoplysninger for at foretage fejlfinding. Hvis du vil have adgang til logføringsoplysninger, skal du vælge fanen API-anmodninger på siden API-anmodningsaktivitet.

Logføring (API-anmodninger)

Siden API-anmodninger indeholder detaljerede oplysninger om alle DE API-anmodninger, der skete i en bestemt tidsramme. Hvis du vil have adgang, skal du vælge fanen API-anmodninger på siden API-anmodningsaktivitet.

logføring af nøglefunktioner:

• Valg af tidsinterval: Du kan vælge forskellige tidsintervaller for de data, der vises på anmodningslisten (Time/Dag/Uge/Måned). Bemærk, at der er en opbevaringsgrænse på 30 dage.

• Få vist en liste over seneste API-anmodninger og tidligere anmodninger, der er angivet med anmodnings-id.
• Få vist handlingens type (forespørgsel eller mutation).
• Få vist den transportprotokol, der bruges af anmodningen (HTTP).
• Få vist tidspunktet for anmodningen.
• Sortér listen over anmodninger efter stigende/faldende tid.
• Få vist anmodningens varighed.
• Sortér listen over anmodninger efter stigende/faldende varighed.
• Vis svarstørrelse.
• Få vist status (udført eller mislykket).
• Få vist detaljerne for anmodningen, herunder specifikke svar-/advarsels-/fejlmeddelelser.
• Filtrer og søg efter bestemte strenge eller sætninger.
• Tilpas størrelsen på kolonnerne, og sortér kolonnerne (stigende/faldende) fra rapporttabellen.

Relateret indhold

• Microsoft Fabric API til GraphQL-
• meddelelse om overvågning af arbejdsområder
• Oversigt over overvågning af arbejdsområde
• API til GraphQL i Fabric-
• Fabric API til GraphQL-editor
• Fabric API til GraphQL-skemavisning og