Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Gebruik Microsoft Foundry Toolkit voor Visual Studio Code om lokale traceringen te verzamelen of telemetrie weer te geven voor agents die zijn geïmplementeerd in Microsoft Foundry. Een trace groepeert opgenomen bewerkingen voor een aanvraag. Elke bewerking is een span met tijdsinformatie, status en eventuele kenmerken of gebeurtenissen die door de instrumentatie worden geleverd.
In dit artikel wordt eerst de lokale verzameling van gegevens behandeld en vervolgens cloudtracering voor geïmplementeerde agents. Kies de gegevensbron die overeenkomt met uw onderzoek:
| Approach | Gebruik het voor | Gegevens en verantwoordelijkheden |
|---|---|---|
| Agentcontrole | Verzend een lokale aanvraag, inspecteer livereactie- en hulpprogrammagebeurtenissen of pauzeer code op een onderbrekingspunt. | De server levert protocol gebeurtenissen en ontwikkelingsdiagnose. Deze benadering vereist de OTLP-collector niet en maakt geen cloudtracegeschiedenis aan. |
| Lokale tracering | Vergelijk opgenomen modellen, hulpprogramma's en agents tijdens de ontwikkeling. | Uw toepassing exporteert telemetrie naar de lokale collector van de toolkit. U configureert instrumentatie en beheert de opgeslagen lokale gegevens. |
| tracering van gehoste agents | Onderzoek aanvragen die worden verwerkt door een agent die is geïmplementeerd in Foundry. | Traceringen bevinden zich in de verbonden Application Insights-resource van het project. Toegang, retentie en kosten volgen de Azure resourceconfiguratie. |
Een gehoste agent voert uw aangepaste code uit in Foundry Agent Service. Foundry beheert hosting, maar u blijft verantwoordelijk voor de code en afhankelijkheden. Tracering vervangt het maken en implementeren van agents niet.
Prerequisites
- Visual Studio Code met de huidige openbare Foundry Toolkit-extensie. Zie Foundry Toolkit installeren.
- Een toepassing die u lokaal kunt uitvoeren, met de bijbehorende model- en hulpprogrammaverbindingen geconfigureerd.
- Voor het eerste voorbeeld: een Python Microsoft Agent Framework-toepassing en de geselecteerde Python-omgeving. Gebruik voor andere SDK's de installatie van de Python of JavaScript en TypeScript.
- Voor cloudtracering is vereist: een geïmplementeerde agent en een Application Insights-resource die is verbonden met het bijbehorende Foundry-project, of toestemming om er verbinding mee te maken of er een te maken.
- Voor cloudquery's de rol Log Analytics Reader op de verbonden Application Insights-resource. Wijs voor beveiligde tabellen ook de rol Privileged Monitoring Data Reader toe. Zie de vereisten voor het traceren van Foundry.
Voor lokale verzameling zijn geen Application Insights- of cloudtelemetriemachtigingen vereist. Modeloproepen en uitvoering van hulpprogramma's kunnen nog steeds gebruikmaken van externe services en kosten met zich meebrengen.
Lokale traces verzamelen
De lokale collector ontvangt telemetrie via OpenTelemetry Protocol (OTLP). Er wordt geen toepassing automatisch geïnstrukeerd. Uw framework of een instrumentatiebibliotheek moet spans maken en exporteren naar de collector.
SDK en taalinstellingen
SDK's met ingebouwde instrumentatie hebben nog steeds een exporteur nodig. Andere SDK's maken gebruik van een afzonderlijk instrumentatiepakket.
| SDK of framework | Python | JavaScript en TypeScript (Node.js) |
|---|---|---|
| Microsoft Agent Framework | Ingebouwde OpenTelemetry-instrumentatie. | Geen richtlijnen voor het instellen van toegewezen toolkits. |
| Azure AI-deductie-SDK (preview) | Azure SDK instrumentor. | Azure SDK instrumentatie. |
| Foundry Projects SDK | Instrumentatie aan clientzijde (preview). | Instrumenteer de onderliggende OpenAI- of Azure SDK-client. |
| Foundry classic Agents SDK | Azure SDK instrumentor. | Geen specifieke richtlijnen voor het instellen van de Toolkit. |
| Anthropic | OpenLLMetry-instrumentor. | Traceloop instrumentatie. |
| Google GenAI (Gemini) | Google GenAI OpenTelemetry instrumentor. | Geen specifieke richtlijnen voor de installatie van de Toolkit. |
| LangChain | OpenLLMetry-instrumentor. | Traceloop instrumentatie. |
| OpenAI SDK, inclusief Azure OpenAI-clients | OpenLLMetry-instrumentor. | Traceloop instrumentatie. |
| OpenAI Agents SDK | OpenLLMetry trace processor. | Geen richtlijnen voor het instellen van een specifieke Toolkit. |
"Geen specifieke Toolkit-installatiehandleiding" betekent dat er hier geen SDK-specifiek installatiepad is voor die taal, niet dat de collector de telemetrie ervan weigert. De collector accepteert OTLP-gegevens. De instrumentor bepaalt welke bewerkingen en berichtdetails worden vastgelegd.
In deze voorbeelden worden geselecteerde instrumentatieopties gebruikt, geen uitputtende lijst van compatibele bibliotheken. OpenLLMetry en Traceloop-instrumentatie zijn niet-Microsoft bibliotheken.
Instrumentatie instellen
Gebruik deze procedure met een bestaande Python Agent Framework-toepassing. Houd de agent en collector in dezelfde lokale omgeving voor dit scenario.
Selecteer Foundry Toolkit in de activiteitenbalk en vervolgens Ontwikkelaarshulpprogramma's>>.
Selecteer Start Collector voordat u de toepassing uitvoert.
Installeer in de Python-omgeving van de toepassing de gRPC-exporteur als deze nog niet is gedeclareerd in uw afhankelijkheden:
python -m pip install opentelemetry-exporter-otlp-proto-grpcNaslaginformatie: OpenTelemetry Python OTLP-exporteurs.
Configureer OpenTelemetry eenmaal bij het opstarten van de toepassing voordat u de agent maakt of uitvoert:
import os os.environ["OTEL_EXPORTER_OTLP_ENDPOINT"] = "http://localhost:4317" os.environ["OTEL_EXPORTER_OTLP_PROTOCOL"] = "grpc" from agent_framework.observability import configure_otel_providers configure_otel_providers(enable_sensitive_data=False)Naslaginformatie: Agent Framework observability.
Als uw toepassing of hostingbibliotheek al OpenTelemetry-providers configureert, configureert u de bestaande exporteurs in plaats van een andere providerconfiguratie toe te voegen. Signaalspecifieke
OTEL_EXPORTER_OTLP_*_ENDPOINTvariabelen kunnen het basiseindpunt overschrijven. Controleer op bestaande instellingen voor tracering, logboek of metrische gegevens die naar een andere locatie verwijzen.Voer de toepassing uit met het normale startpunt en verzend een aanvraag waarmee de agent wordt aangesproken. Wacht tot het verzoek is voltooid en geef de exporteur tijd om telemetrie te verzenden voordat u het proces stopt.
Selecteer in TraceringVernieuwen en selecteer vervolgens de nieuwe tracering om de spans ervan te controleren.
Agent Framework-instrumenten ondersteunden modelclients, agents en workflowbewerkingen. Andere frameworks kunnen een instrumentatiebibliotheek vereisen. Met OTLP-compatibiliteit kan de collector gegevens ontvangen, terwijl uitgezonden attributen en generatieve AI-semantische conventies bepalen wat de viewer weergeeft.
Voor een andere SDK of taal gebruikt u de onderstaande instellingen in plaats van de Agent Framework-configuratie. Start de collector eerst, configureer instrumentatie voordat u clients maakt, voer vervolgens uw toepassing uit en vernieuw de traceringslijst.
collector-eindpunten
Koppel het exportprotocol aan het eindpunt van de collector. De toolkit luistert op localhost met de volgende standaardwaarden:
| Exporteur | Endpoint |
|---|---|
| OTLP gRPC | http://localhost:4317 |
| OTLP HTTP-trace-exporteur | http://localhost:4318/v1/traces |
| OTLP HTTP-logexporter | http://localhost:4318/v1/logs |
Sommige HTTP-exporteurs accepteren http://localhost:4318 en voegen het signaalpad zelf toe. Volg de configuratie van uw exporteur in plaats van het pad twee keer toe te voegen. Sommige instrumentatiebibliotheken verzenden berichtinhoud als logboekrecords, waardoor het exporteren van alleen spans geen invoer- en uitvoerdetails biedt.
Deze poorten zijn niet gerelateerd aan de HTTP-server van de agent en foutopsporingsprogrammapoorten. In een container of externe ontwikkelomgeving verwijst localhost naar die omgeving. Maak de juiste verbinding met de collector in plaats van ervan uit te gaan dat deze naar uw bureaublad verwijst.
Python SDK-configuratie
In de volgende voorbeelden wordt ervan uitgegaan dat uw toepassing al de model-SDK, inloggegevens en modelconfiguratie heeft. Installeer de gedeelde afhankelijkheden en het extra pakket voor uw SDK uit de volgende tabel:
python -m pip install opentelemetry-sdk opentelemetry-exporter-otlp-proto-http
Naslaginformatie: OpenTelemetry Python SDK, OTLP-exporteurs.
Voeg deze gedeelde configuratie eenmaal toe bij het opstarten van de applicatie, gevolgd door de instrumentatie van één rij in de tabel. Combineer dit niet met de providerinstallatie van een andere bibliotheek.
import os
os.environ["TRACELOOP_TRACE_CONTENT"] = "false"
os.environ["OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT"] = "false"
os.environ["AZURE_TRACING_GEN_AI_CONTENT_RECORDING_ENABLED"] = "false"
from opentelemetry import trace
from opentelemetry.sdk.resources import Resource
from opentelemetry.sdk.trace import TracerProvider
from opentelemetry.sdk.trace.export import BatchSpanProcessor
from opentelemetry.exporter.otlp.proto.http.trace_exporter import (
OTLPSpanExporter,
)
provider = TracerProvider(
resource=Resource.create({"service.name": "my-agent"})
)
provider.add_span_processor(BatchSpanProcessor(
OTLPSpanExporter(endpoint="http://localhost:4318/v1/traces")
))
trace.set_tracer_provider(provider)
Naslaginformatie: TracerProvider en span processors, OTLPSpanExporter.
Installeer het pakket in de gekozen rail met python -m pip install <package>. De voorbeelden van OpenAI, Anthropic, LangChain en afzonderlijke voorbeelden van OpenAI Agents maken gebruik van niet-Microsoft OpenLLMetry-instrumentatie. SDK-versies en model-API's kunnen verschillende details produceren.
| SDK | Extra pakket | Instrumentatie na de gedeelde configuratie |
|---|---|---|
| OpenAI, inclusief Azure OpenAI-clients | opentelemetry-instrumentation-openai |
from opentelemetry.instrumentation.openai import OpenAIInstrumentorOpenAIInstrumentor().instrument() |
| Anthropic | opentelemetry-instrumentation-anthropic |
from opentelemetry.instrumentation.anthropic import AnthropicInstrumentorAnthropicInstrumentor().instrument() |
| LangChain | opentelemetry-instrumentation-langchain |
from opentelemetry.instrumentation.langchain import LangchainInstrumentorLangchainInstrumentor().instrument() |
| Google GenAI | opentelemetry-instrumentation-google-genai |
os.environ["OTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT"] = "NO_CONTENT"from opentelemetry.instrumentation.google_genai import GoogleGenAiSdkInstrumentorGoogleGenAiSdkInstrumentor().instrument() |
| clientzijdige tracering voor Foundry Projects (preview) |
azure-core-tracing-opentelemetry, naast azure-ai-projects |
os.environ["AZURE_EXPERIMENTAL_ENABLE_GENAI_TRACING"] = "true"from azure.ai.projects.telemetry import AIProjectInstrumentorAIProjectInstrumentor().instrument(enable_content_recording=False) |
| Foundry classic Agents SDK |
azure-core-tracing-opentelemetry, naast azure-ai-agents |
os.environ["AZURE_SDK_TRACING_IMPLEMENTATION"] = "opentelemetry"from azure.ai.agents.telemetry import AIAgentsInstrumentorAIAgentsInstrumentor().instrument() |
| Azure AI Inference SDK (preview) |
azure-core-tracing-opentelemetry, naast azure-ai-inference |
os.environ["AZURE_SDK_TRACING_IMPLEMENTATION"] = "opentelemetry"from azure.ai.inference.tracing import AIInferenceInstrumentorAIInferenceInstrumentor().instrument() |
Voor Foundry Projects moet u de traceringsrichtlijnen aan de clientzijde volgen en de OpenAI-client na instrumentatie maken. Deze richtlijnen verschillen van de klassieke Agents SDK. Instrumenteer niet dezelfde OpenAI-aanroepen met beide AIProjectInstrumentor en een afzonderlijke OpenAI-instrumentor.
Voor OpenAI Agents SDK, installeer opentelemetry-instrumentation-openai-agents en voeg deze code toe na de gedeelde installatie:
from agents import set_trace_processors
from opentelemetry.instrumentation.openai_agents import OpenAIAgentsInstrumentor
set_trace_processors([])
OpenAIAgentsInstrumentor().instrument()
Referentie: OpenAI Agents instrumentation, OpenAI Agents tracing.
In dit voorbeeld worden bestaande traceringsprocessors vervangen voordat u de OpenTelemetry-processor toevoegt. Zonder deze vervanging kan de SDK ook traceringen exporteren naar de standaardback-end. Als u bestaande processors nodig hebt, controleert u de traceringsbestemmingen voordat u deze wijzigt. Houd SDK-tracering ingeschakeld zodat de OpenTelemetry-processor gebeurtenissen ontvangt.
Nadat een kortdurende applicatie zijn verzoeken heeft voltooid, roep provider.force_flush() aan voordat u afsluit om gebufferde spans te verzenden. Gebruik de Tracing Code Gen tool van de Toolkit voor hulp bij het aanpassen van deze fragmenten.
Logboekrecords van berichten exporteren
Sommige instrumentors genereren berichtinhoud als OpenTelemetry-logboekrecords in plaats van spankenmerken. Als u ervoor kiest om die inhoud op te nemen in een gecontroleerde ontwikkelingstest, voegt u deze configuratie eenmaal toe naast de voorgaande Python traceringsprovider:
from opentelemetry import _logs
from opentelemetry.sdk._logs import LoggerProvider
from opentelemetry.sdk._logs.export import BatchLogRecordProcessor
from opentelemetry.exporter.otlp.proto.http._log_exporter import OTLPLogExporter
logger_provider = LoggerProvider(resource=provider.resource)
logger_provider.add_log_record_processor(BatchLogRecordProcessor(
OTLPLogExporter(endpoint="http://localhost:4318/v1/logs")
))
_logs.set_logger_provider(logger_provider)
Naslaginformatie: OpenTelemetry Python logging SDK, OTLPLogExporter.
Roep logger_provider.force_flush() aan voordat u een toepassing met een korte levensduur afsluit. Een logexporteur schakelt niet zelf content vastleggen in. Volg de inhoudsinstellingen van uw instrumentatieprogramma en de richtlijnen voor gegevensverwerking.
Installatie van de JavaScript- en TypeScript-SDK
Voor Node.js-toepassingen deelt u één traceringsprovider en registreert u de instrumentatie voor uw SDK. In dit voorbeeld worden CommonJS en de Configuratie van de OpenTelemetry JavaScript 2.x-provider gebruikt. TypeScript-toepassingen die zijn gecompileerd naar CommonJS, kunnen dezelfde initialisatievolgorde gebruiken.
Uw toepassing moet al de model-SDK, inloggegevens en modelconfiguratie hebben. Installeer de gedeelde afhankelijkheden en de OpenAI-instrumentor:
npm install @opentelemetry/api @opentelemetry/sdk-trace-node \
@opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-proto \
@opentelemetry/instrumentation @traceloop/instrumentation-openai
Referentie: OpenTelemetry JavaScript-exporters, OpenAI-instrumentatie.
Maak tracing.cjs:
const { NodeTracerProvider } = require('@opentelemetry/sdk-trace-node');
const { BatchSpanProcessor } = require('@opentelemetry/sdk-trace-base');
const {
OTLPTraceExporter
} = require('@opentelemetry/exporter-trace-otlp-proto');
const { registerInstrumentations } = require('@opentelemetry/instrumentation');
const { OpenAIInstrumentation } = require('@traceloop/instrumentation-openai');
const provider = new NodeTracerProvider({
spanProcessors: [
new BatchSpanProcessor(new OTLPTraceExporter({
url: 'http://localhost:4318/v1/traces'
}))
]
});
provider.register();
registerInstrumentations({
instrumentations: [new OpenAIInstrumentation({ traceContent: false })]
});
module.exports = provider;
Naslaginformatie: NodeTracerProvider, OpenAI-instrumentatie.
Laad dit bestand voordat u de model-SDK importeert of opneemt. Voer bijvoorbeeld node --require ./tracing.cjs app.cjs uit voor een CommonJS-toepassing. Voor een andere SDK vervang je het OpenAI-pakket, de import en de registratievermelding door die uit de overeenkomstige rij:
| SDK | Instrumentatiepakket | Import- en registratie-item |
|---|---|---|
| OpenAI, inclusief Azure OpenAI-clients | @traceloop/instrumentation-openai |
const { OpenAIInstrumentation } = require('@traceloop/instrumentation-openai');new OpenAIInstrumentation({ traceContent: false }) |
| Anthropic | @traceloop/instrumentation-anthropic |
const { AnthropicInstrumentation } = require('@traceloop/instrumentation-anthropic');new AnthropicInstrumentation({ traceContent: false }) |
| LangChain | @traceloop/instrumentation-langchain |
const { LangChainInstrumentation } = require('@traceloop/instrumentation-langchain');new LangChainInstrumentation({ traceContent: false }) |
| Azure SDK-bewerkingen, waaronder Azure AI Inference | @azure/opentelemetry-instrumentation-azure-sdk |
const { createAzureSdkInstrumentation } = require('@azure/opentelemetry-instrumentation-azure-sdk');createAzureSdkInstrumentation() |
De Traceloop-pakketten zijn niet-Microsoft instrumentatie. Instrumenteer voor een Foundry Projects-toepassing de client die het modelverzoek doet. Azure SDK instrumentatie vervangt openAI-instrumentatie niet voor aanroepen via een OpenAI-client.
Voor native ECMAScript-modules volgt u de ESM-configuratie van OpenTelemetry. Het laden van instrumentatie na de doel-SDK kan ertoe leiden dat aanroepen niet worden geïnstrumenteerd. Wacht bij het afsluiten op provider.shutdown() nadat aanvragen zijn voltooid om gebufferde spans te exporteren.
Important
In deze voorbeelden wordt het vastleggen van berichtinhoud voor de vermelde GenAI-instrumentors uitgeschakeld. Dit is geen algemene redigeringsgarantie. Bekijk andere exporteurs, SDK-logregistratie, span-attributen en aangepaste instrumentatie voordat u gegevens deelt. Raadpleeg de documentatie voor de gekoppelde instrumentor voor ondersteunde pakketten en API's.
Lokale traces inspecteren en beheren
Gebruik de span tree om het verzoek van agentorkestratie naar model- en toolbewerkingen te volgen.
- Selecteer een trage of mislukte span.
- Controleer de duur en status.
- Open Input + Output voor opgenomen berichten, wanneer deze worden geleverd door de instrumentatie, of Metadata voor span-attributen.
In de voorbeelden staat het vastleggen van gevoelige inhoud uit. Timinggegevens zonder berichten kunnen het verwachte resultaat zijn.
Voor een gecontroleerde Agent Framework-ontwikkeltest stelt u enable_sensitive_data=True in de bestaande configuratie in om ondersteunde prompt-, antwoord- en hulpprogramma-inhoud vast te leggen. Herstel deze naar False wanneer de test is voltooid. Andere instrumentatieprogramma's hebben hun eigen contentinstellingen.
Caution
Inhoudsopname kan persoonlijke gegevens, geheimen, hulpprogrammaargumenten en resultaten vastleggen. Gebruik niet-gevoelige testgegevens en minimaliseer of redigeer inhoud voordat inhoud in de telemetrie terechtkomt. Schakel de opname van productie-inhoud niet alleen in om een lege invoer- en uitvoerweergave te vullen.
Verzamelde traceringen blijven behouden in een lokale SQLite-database met de naam traces.db, in de submap tracing van .aitk in de homemap van uw gebruiker. Als u de viewer sluit, worden ze niet verwijderd.
Selecteer Collector stoppen om de lokale verzameling te stoppen. Uw agent en de modeloproepen blijven actief. Als u lokale records wilt verwijderen, selecteert u de traces in de lijst en selecteert u Delete.
Lokale opslag staat los van Application Insights. Als u lokale traceringen verwijdert, worden geen cloudtelemetrie verwijderd en wordt een gesprek in Inspector niet verwijderd.
Traceringen van gehoste agents weergeven
Na de implementatie gebruikt u cloudtraceringen om de agent te onderzoeken die wordt uitgevoerd in Foundry in plaats van uw lokale proces. De toolkit voert een query uit op de verbonden Application Insights-resource van het project. Het uploadt uw lokale tracedatabase niet.
Bevestig de vereisten voor de cloud voordat u begint. Alleen toegang tot de agent verleent geen machtiging voor het uitvoeren van query's op telemetrie.
Verbinding maken met Application Insights en een aanvraag inspecteren
Gebruik het tabblad Traceringen van de agent om Application Insights te verbinden en een aanvraag voor een geïmplementeerde agent te vinden.
Open My Resources>Agents in de zijbalk foundry toolkit. Selecteer het tabblad Hosted Agent en selecteer vervolgens de naam van de agent.
Selecteer Traces. Als het project geen verbonden resource heeft, selecteert u App Insights inschakelen.
Selecteer een bestaande Application Insights-resourcenaam in App Insights-instellingen. U kunt ook een resource maken en de vereiste resource- en werkruimtevelden voltooien. Selecteer Verzenden en wacht op bevestiging.
Hierdoor wordt de gedeelde Application Insights-verbinding van het project gewijzigd, niet een lokale werkruimtevoorkeur. Voor het maken van resources en het verzamelen van telemetriegegevens kunnen Azure kosten in rekening worden gebracht. Bevestig het beoogde project en de beoogde resource voordat u het indient.
Ga terug naar Playground en verzend een testaanvraag naar de geïmplementeerde agent.
Wacht even tot de gegevens zijn verwerkt en open Traces opnieuw. Gebruik het tijdsbereik, zoek op gespreks-id, status of duurfilters om de aanvraag te vinden.
Selecteer een trace en vervolgens een span om metagegevens en invoer en uitvoer te controleren wanneer inhoud beschikbaar is.
Als u bewerkingen wilt controleren die zijn gekoppeld aan een gesprek, selecteert u de gespreks-id in de traceringslijst. In de gespreksweergave ziet u een bewerkingsboom en metagegevens.
Het verbinden van Application Insights maakt tracering aan de serverzijde van Foundry mogelijk. Zichtbaarheid van uw modeloproepen, hulpprogramma-aanroepen en aangepaste code is ook afhankelijk van de hostingbibliotheek en framework-instrumentatie. Zie Tracering instellen in Foundry voor verzameling aan de servicezijde en aanvullende client instrumentatie.
De traceringsdetailquery van de toolkit heeft momenteel betrekking op de afgelopen zeven dagen. Dit is een queryvenster, geen retentie-instelling. Voor oudere gegevens gebruikt u de Foundry-portal of Azure Monitor, onder voorbehoud van de retentieconfiguratie van de verbonden werkruimte.
Gegevens, toegang, bewaartermijn en kosten
Bepaal waar telemetrie naartoe moet voordat inhoud wordt vastgelegd of een cloudresource wordt verbonden. Datzelfde verzoek kan lokale spans, cloudtelemetrie en gegevens genereren die worden verzonden naar model- of hulpprogrammaproviders.
| Gegevensbron | Responsibilities |
|---|---|
| Lokale traces | Beveilig de toegang tot de lokale database en gekopieerde gegevens. Als u de collector stopt, worden andere exporteurs die in uw toepassing zijn geconfigureerd, niet gestopt. |
| Cloudtraces | Application Insights en Log Analytics de toegang, retentie en telemetriekosten beheren. Toolkitfilters wijzigen dat beleid niet. |
| Model- en toolaanroepen | Lokale collectie voorkomt niet dat verzoeken uw computer verlaten. Controleer de gegevensverwerking van elke verbonden service, inclusief niet-Microsoft hulpprogramma's. |
Gebruik de richtlijnen voor het traceren van Foundry voor beveiliging en privacy en gegevensretentie en -kosten. Voor productie-identiteit, netwerkisolatie en downstreamtoegang volg de beveiliging en gegevensverwerking van gehoste agents. Behandel lokale aanmeldingsgegevens niet als de machtigingen van de geïmplementeerde agent.
Troubleshooting
| Issue | Wat u moet controleren |
|---|---|
| Tracering is niet beschikbaar in de zijbalk. | Controleer of de huidige extensie is geïnstalleerd en ingeschakeld in de omgeving waarin u deze uitvoert. Voor lokale tracering moet het systeemeigen SQLite-onderdeel laden. |
| De collector start niet op. | Controleer op een ander proces met poort 4317 of 4318 en controleer de uitvoer van de toolkit. Vermijd concurrerende collectors op dezelfde poorten. |
| Een lokale aanvraag slaagt, maar er wordt geen tracering weergegeven. | Bevestig dat instrumentatie wordt uitgevoerd voordat de request wordt uitgevoerd, de collector wordt uitgevoerd en dat de exporteur het juiste protocol en eindpunt gebruikt. Controleer eindpuntoverschrijvingen, fouten van exporteurs en gebufferde telemetrie en selecteer Vernieuwen. |
| Spans worden zonder berichten weergegeven. | Controleer de instellingen voor het opnemen van inhoud en ondersteunde kenmerken. Voor sommige bibliotheken is ook een logboekexporteur vereist. Ontbrekende inhoud betekent niet noodzakelijkerwijs dat de verzameling is mislukt. |
| Cloudtraces zijn leeg. | Bevestig het project en de verbinding met Application Insights, genereer nieuw verkeer, breid het tijdsbereik uit en houd rekening met de vertragingsperiode bij gegevensopname. |
| Cloud queries mislukken met een autorisatiefout. | Controleer leestoegang tot Application Insights en Log Analytics, inclusief beveiligde tabellen, met behulp van de servicevereisten. |
| Een oudere trace bevat geen detailinformatie in de toolkit. | De detailquery omvat zeven dagen. Een query uitvoeren op oudere bewaarde records in Foundry of Azure Monitor. |