Veelgestelde vragen over het oplossen van problemen met Azure SRE-agentbewerkingen

In dit artikel worden veelvoorkomende operationele problemen behandeld bij het werken met Azure SRE Agent, samen met praktische oplossingen. Deze problemen hebben doorgaans betrekking op machtigingen, regionale beschikbaarheid, implementatieproblemen en beheertoegangsvereisten.

Veelvoorkomende scenario's voor probleemoplossing

De volgende tabel bevat een overzicht van veelvoorkomende problemen en de bijbehorende oplossingen. Zie Rollen en machtigingen voor meer informatie over hoe rollen en machtigingen worden toegepast op een agent.

Scenario Reden Oplossing
De agent toont een machtigingsfout in de chat- en kennisgrafiek. De agent wordt gemaakt met inzendertoegang en een account met alleen lezermachtigingen probeert te communiceren met de agent. Inzender of eigenaar toegang verlenen tot het gebruikersaccount in de resourcegroep.
De vervolgkeuzelijst voor de locatie is leeg. Een niet-Amerikaans regiobeleid blokkeert de toegang tot Zweden - centraal. Als uw abonnement of beheergroep is beperkt tot implementaties in de VS, gebruikt u VS - oost 2 voor implementatie.
De knop Maken is niet beschikbaar. Het gebruikersaccount heeft geen beheerdersmachtigingen. Zorg ervoor dat het gebruikersaccount eigenaars - of beheerdersmachtigingen voor gebruikerstoegang heeft.
Agent kan geen query's uitvoeren op logboeken of metrische gegevens. Onvoldoende machtigingen voor Log Analytics-werkruimten. Verken de beheerde identiteit van de agent Log Analytics Reader-machtigingen voor doelwerkruimten.
Externe integraties mislukken. Problemen met netwerkconnectiviteit of verificatie. Controleer de firewallregels en controleer de configuraties van de serviceprincipal.

Implementatieproblemen

In de volgende secties worden veelvoorkomende problemen behandeld die kunnen optreden bij het implementeren van de Azure SRE-agent.

Implementatie is niet gevonden

U kunt een fout tegenkomen die aangeeft dat de implementatie om verschillende redenen niet is gevonden. Zorg er eerst voor dat u uw agent correct benoemt en dat u de juiste firewallregels hebt.

  • Zorg ervoor dat de naam van de agent uniek is in het abonnement.
  • Controleer op geo-blokkerende of firewallregels die de toegang tot het agenteindpunt kunnen voorkomen.

Als uw naamgeving en de netwerkconfiguratie juist zijn, gebruikt u de volgende stappen om de agent 'DeploymentNotFound'-fout op te lossen.

Schermopname van een melding van een inrichtingsfout in De Azure SRE-agent.

  1. Controleer of uw gebruikersaccount eigenaars- of beheerdersmachtigingen heeft, samen met machtigingen voor het maken van resources in de regio's Zweden - centraal, VS - oost 2 of Australië - oost (afhankelijk van uw implementatie).

  2. Controleer of het abonnement in de acceptatielijst voor SRE Agent staat. Voer de volgende opdracht uit:

    az provider show -n Microsoft.App | grep -C 15 agents

    Als uw abonnement in de acceptatielijst staat, krijgt u uitvoer die vergelijkbaar is met het volgende bericht.

    Schermopname van een consoleantwoord waarmee gebruikerstoegang tot agents wordt geverifieerd.

    Zoek specifiek naar "resourcetype : agents" en "defaultApiVersion : 2025-05-01-preview".

    Als het uitvoeren van deze opdracht niet het verwachte resultaat geeft, moet u uw abonnement registreren.

  3. Als u uw abonnement opnieuw wilt registreren, voert u de az provider register opdracht uit in Azure Cloud Shell via Azure Portal:

    az provider register --namespace "Microsoft.App"

    Probeer vervolgens de agent opnieuw te maken.

Implementatievalidatiefouten

Als de implementatievalidatie mislukt:

  1. Controleer de resourcequota: zorg ervoor dat uw abonnement een beschikbaar quotum heeft voor de implementatieregio.
  2. Controleer de registratie van de resourceprovider: controleer of de Microsoft.App-provider geregistreerd is.
  3. Controleer Azure Policy: Controleer of organisatiebeleid het maken van resources blokkeert.

Problemen met machtigingen en toegang

In de volgende secties worden problemen behandeld met betrekking tot machtigingen en toegangsbeheer voor Azure SRE Agent.

Machtigingsfouten

Als u niet met de agent kunt chatten of ermee kunt werken, kan het probleem te maken hebben met een fout 403 Verboden of een CORS-beleidsfout (Cross-Origin Resource Sharing). In de volgende schermopname ziet u een voorbeeld van het foutbericht.

Schermopname van fouten die het gevolg zijn van onjuiste machtigingen.

Of u krijgt mogelijk de volgende uitvoer in uw netwerktracering.

Schermopname van een browsernetwerktracering wanneer de agent een machtigingsfout krijgt.

Het probleem oplossen:

  • Zorg ervoor dat u over de rol 'Contributor' of 'Owner' beschikt voor de resourcegroep die de agent host.
  • Vermijd dat u alleen vertrouwt op roltoewijzingen op basis van groepen. Wijs rollen rechtstreeks toe aan uw account als de problemen zich blijven voordoen.
  • Gebruik de functie Toegang controleren in Azure Portal om te controleren of u over de juiste machtigingen beschikt.

Problemen met door agents beheerde identiteiten

Als de agent geen toegang heeft tot Azure-resources:

  1. Verifieer de creatie van beheerde identiteit: Controleer of de beheerde identiteit van de agent succesvol is gemaakt.
  2. Roltoewijzingen controleren: zorg ervoor dat de beheerde identiteit over de juiste machtigingen beschikt voor doelbronnen.
  3. Controleer het beleid voor voorwaardelijke toegang: zorg ervoor dat organisatiebeleid de toegang tot beheerde identiteiten niet blokkeert.

Netwerk- en connectiviteitsproblemen

De volgende secties helpen u bij het oplossen van netwerk- en verbindingsproblemen die van invloed kunnen zijn op de Azure SRE-agent.

Portal reageert niet meer

Als Azure Portal niet meer reageert terwijl u SRE Agent probeert te gebruiken, blokkeren uw firewallregels mogelijk de toegang tot een Azure-domein.

Als u toegang wilt verlenen tot het juiste domein, voegt u toe *.azuresre.ai aan de acceptatielijst in uw firewallinstellingen. Zscaler kan standaard de toegang tot *.azuresre.ai het domein blokkeren.

WebSocket-verbindingsfouten

Als realtime chatfuncties niet werken:

  1. Controleer de proxyinstellingen: bedrijfsproxy's blokkeren mogelijk WebSocket-verbindingen.
  2. Controleer de firewallregels: zorg ervoor dat *.azuresre.ai de acceptatielijst voor zowel HTTP- als WebSocket-verkeer staat.
  3. Netwerkconnectiviteit testen: gebruik hulpprogramma's voor browserontwikkelaars om te controleren op verbindingsfouten.

Prestatieproblemen

In de volgende secties worden veelvoorkomende prestatieproblemen met de Azure SRE-agent opgelost.

Trage reactietijden

Als agentreacties langzamer zijn dan verwacht:

  1. Controleer de Azure-servicestatus: controleer geen storingen in uw implementatieregio.
  2. Complexiteit van query's controleren: complexe logboekquery's kunnen langer duren voordat ze worden verwerkt.
  3. Resourcelimieten bewaken: Zorgen ervoor dat de doelbronnen (Log Analytics en andere) niet worden beperkt.

Problemen met het laden van chatinterfaces

Als de chatinterface niet wordt geladen:

  1. Browsercache wissen: Forceer de pagina te vernieuwen (Ctrl+F5).
  2. Probeer incognito of privé browsen: sluit conflicten met browseruitbreidingen uit.
  3. Controleer de JavaScript-console: zoek naar foutberichten in hulpprogramma's voor browserontwikkelaars.

Problemen met integratie oplossen

De volgende secties helpen u bij het oplossen van problemen met externe service-integraties.

GitHub- of Azure DevOps-verbindingsfouten

Als integraties van broncodebeheer mislukken:

  1. Verificatie verifiëren: controleer de machtigingen van de service-principal of het persoonlijke toegangstoken.
  2. API-toegang testen: zorg ervoor dat de agent api's voor externe services kan bereiken.
  3. Controleer de firewallregels: controleer de uitgaande toegang tot github.com of dev.azure.com.

Problemen met aangepaste MCP-servers

Als aangepaste Model Context Protocol-servers niet werken:

  1. Controleer de serverstatus: controleer of de MCP-server wordt uitgevoerd en toegankelijk is.
  2. Testverificatie: zorg voor de juiste verificatieconfiguratie.
  3. Logboeken controleren: Controleer agentlogboeken op verbindings- of protocolfouten.

Problemen met gegevens en opslag

In de volgende secties worden problemen behandeld met betrekking tot gegevensopslag en het ophalen in Azure SRE Agent.

Ontbrekende gespreksgeschiedenis

Als gespreksthreads verdwijnen:

  1. Controleer de instellingen voor gegevensretentie: controleer het geconfigureerde bewaarbeleid.
  2. Toegangsmachtigingen controleren: Zorg ervoor dat u toegang hebt tot de gespreksgegevens.
  3. Neem contact op met ondersteuning: voor hulp bij gegevensherstel.

Fouten bij het uploaden van knowledge base

Als het uploaden van documenten naar de Knowledge Base mislukt:

  1. Controleer de bestandsgroottelimieten: Zorg ervoor dat documenten binnen de beperkingen van de grootte vallen.
  2. Controleer de bestandsindelingen: bevestig ondersteunde documenttypen.
  3. Controleer de opslagmachtigingen: Controleer de toegang van beheerde identiteiten tot blobopslag.

Hulp krijgen

Gebruik de volgende bronnen als u meer hulp nodig hebt dan wat in deze handleiding wordt behandeld.

Escalatiepaden

Probeer de volgende opties voor problemen die niet worden behandeld in deze handleiding:

  • Azure-ondersteuning: Maak een ondersteuningsticket voor implementatie- of serviceproblemen.
  • Microsoft Docs: Raadpleeg de officiële documentatie voor updates.
  • Azure-status: controleer de azure-statuspagina voor servicestoringen.

Verwante inhoud

  • Last updated on