AgentCore generierte Beobachtbarkeitsdaten für integrierte Tools
Themen
Tools zur Beobachtbarkeit und Metriken
AgentCore bietet die folgenden integrierten Metriken für den Code-Interpreter und die Browser-Tools. Built-in Tool-Metriken werden in Intervallen von einer Minute gebündelt. Weitere Informationen zu AgentCore Tools finden Sie unter Code ausführen und Daten analysieren mit Amazon Bedrock AgentCore Code Interpreter und Interagieren mit Webanwendungen mithilfe des Amazon AgentCore Bedrock Browsers.
Tool aufrufen:
- Aufrufe
-
Die Gesamtzahl der Anfragen an die Data Plane API. Jeder API-Aufruf zählt als ein Aufruf, unabhängig von der Größe der Anforderungsnutzlast oder dem Antwortstatus.
- Drosselungen
-
Die Anzahl der Anfragen, die vom Dienst aufgrund der Überschreitung der zulässigen TPS- (Transaktionen pro Sekunde) oder der Kontingentgrenzen gedrosselt wurden. Diese Anfragen werden ThrottlingException mit dem HTTP-Statuscode 429 zurückgegeben.
- SystemErrors
-
Die Anzahl der serverseitigen Fehler, die bei der Anforderungsverarbeitung aufgetreten sind.
- UserErrors
-
Die Anzahl der clientseitigen Fehler, die auf ungültige Anfragen zurückzuführen sind. Zur Behebung dieser Probleme ist eine Benutzeraktion erforderlich.
- Latenz
-
Die Zeit, die zwischen dem Empfang der Anfrage durch den Dienst und dem Beginn des Sendens des ersten Antwort-Tokens verstrichen ist. Wichtig für die Messung der ersten Reaktionszeit.
Toolsitzung erstellen:
- Aufrufe
-
Die Gesamtzahl der Anfragen an die Data Plane API. Jeder API-Aufruf zählt als ein Aufruf, unabhängig von der Größe der Anforderungsnutzlast oder dem Antwortstatus.
- Drosselungen
-
Die Anzahl der Anfragen, die vom Dienst aufgrund der Überschreitung der zulässigen TPS- (Transaktionen pro Sekunde) oder der Kontingentgrenzen gedrosselt wurden. Diese Anfragen werden ThrottlingException mit dem HTTP-Statuscode 429 zurückgegeben.
- SystemErrors
-
Die Anzahl der serverseitigen Fehler, die bei der Anforderungsverarbeitung aufgetreten sind.
- UserErrors
-
Die Anzahl der clientseitigen Fehler, die auf ungültige Anfragen zurückzuführen sind. Zur Behebung dieser Probleme ist eine Benutzeraktion erforderlich.
- Latenz
-
Die Zeit, die zwischen dem Empfang der Anfrage durch den Dienst und dem Beginn des Sendens des ersten Antwort-Tokens verstrichen ist. Wichtig für die Messung der ersten Reaktionszeit.
- Dauer
-
Die Dauer der Werkzeugsitzung (Operation wird CodeInterpreterSession/BrowserSession).
Übernahme durch den Browser-Benutzer:
- TakerOverCount
-
Die Gesamtzahl der Benutzer, die den Dienst übernehmen
- TakerOverReleaseCount
-
Die Gesamtzahl der Benutzer, die die Kontrolle abgegeben haben
- TakerOverDuration
-
Die Dauer der Übernahme durch den Benutzer
Metriken und Protokolle zur Ressourcennutzung
Amazon Bedrock AgentCore Built-in Tools bietet umfassende Telemetrie zur Ressourcennutzung, einschließlich Kennzahlen zum CPU- und Speicherverbrauch für Ihre Laufzeitressourcen.
Anmerkung
Daten zur Ressourcennutzung können sich um bis zu 60 Minuten verzögern, und die Genauigkeit kann je nach Messwert unterschiedlich sein.
Verkaufte Metriken
Standardmäßig verkauft Bedrock AgentCore Built-in Tools Metriken für Account- und Tool-Ebene mit einer Auflösung von 1 Minute. Die CloudWatch Amazon-Aggregation und die Aufbewahrung von metrischen Daten folgen den Standardrichtlinien von Amazon CloudWatch zur Datenspeicherung. Weitere Informationen finden Sie unter https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html #Metric.
| Name | Dimensionen | Description |
|---|---|---|
|
CPUUsed-vCPUHours |
Service; Service, Ressource |
Die Gesamtmenge der verbrauchten virtuellen CPU in CPU-Hours V-Einheiten, verfügbar auf Ressourcen- und Kontoebene. Nützlich für die Nachverfolgung von Ressourcen und die Transparenz der geschätzten Rechnungsstellung. |
|
MemoryUsed-GBHours |
Service; Service, Ressource |
Die Gesamtmenge des verbrauchten Speichers GB-Hours pro Einheit, verfügbar auf Ressourcen- und Kontoebene. Nützlich für die Nachverfolgung von Ressourcen und die Transparenz der geschätzten Rechnungsstellung. |
Erläuterung der Abmessungen
-
Service - AgentCore.CodeInterpreter oder AgentCore.Browser
-
Ressource — Built-in Werkzeug-ID
Metriken auf Kontoebene sind in der Amazon CloudWatch Bedrock AgentCore Observability Console auf der Registerkarte Built-in Tools verfügbar. Das Dashboard auf der Konsole enthält ein Diagramm zur Speicherauslastung und ein Diagramm zur CPU-Auslastung, das anhand der Nutzungsmetriken generiert wird. Diese Diagramme stellen den gesamten Ressourcenverbrauch aller Tools des ausgewählten Tooltyps im Konto in der Region dar.
Metriken auf Tool-Ebene sind auf der Seite Tools der Amazon CloudWatch Bedrock AgentCore Observability Console verfügbar. Das Dashboard auf der Konsole wird ein Diagramm zur Speicherauslastung und ein Diagramm zur CPU-Auslastung enthalten, das anhand der Nutzungsmetriken generiert wird. Die Diagramme stellen den gesamten Ressourcenverbrauch in allen Sitzungen des ausgewählten Tools dar.
Anmerkung
Telemetriedaten werden zu Überwachungszwecken bereitgestellt. Die tatsächliche Abrechnung wird auf der Grundlage der gemessenen Nutzungsdaten berechnet und kann aufgrund der Aggregationszeit, der Abstimmungsprozesse und der Messgenauigkeit von den Telemetriewerten abweichen. Die verbindlichen Gebühren entnehmen Sie Ihrer AWS Abrechnung.
Verkaufte Logs
Amazon Bedrock AgentCore Built-in Tools bietet die Möglichkeit, verkaufte Protokolle für Nutzungstelemetrie auf Sitzungsebene mit einer Granularität von 1 Sekunde zu aktivieren. Jeder Protokolldatensatz enthält ein Datum zur Ressourcennutzung für 1 Sekunde. Derzeit werden unter anderem folgende Metriken unterstützt:
-
Code des Code-Interpreters Interpreter.vcpu.hours.used und Code _hours.used Interpreter.memory.gb
-
Browser browser.vcpu.hours.used und browser.memory.gb_hours.used
Für jedes Datum der Ressourcennutzung wird das folgende Schema im Protokolldatensatz verwendet.
Code-Interpreter
| Protokolltyp | Protokollfelder | Description |
|---|---|---|
|
NUTZUNGSPROTOKOLLE |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, code, code _hours.used Interpreter.vcpu.hours.used Interpreter.memory.gb |
Ressourcennutzungsprotokolle für die Ressourcenverfolgung auf Sitzungsebene. |
Browser
| Protokolltyp | Protokollfelder | Description |
|---|---|---|
|
USAGE_LOGS |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, elapsed_time_seconds, browser.vcpu.hours.used, browser.memory.gb_hours.used |
Ressourcennutzungsprotokolle für die Ressourcenverfolgung auf Sitzungsebene. |
Weitere Informationen zur Aktivierung von Protokollen finden Sie unter Hinzufügen von Observability zu Ihren Amazon Bedrock-Ressourcen AgentCore . Diese Protokolle werden dann im konfigurierten Ziel angezeigt (AWS LogGroupAmazon S3 oder Amazon Kinesis Firehose).
Auf der Seite Built-in Tools Session der Amazon CloudWatch Bedrock AgentCore Observability Console können Sie anhand dieser Protokolle generierte Messwerte zur Ressourcennutzung sehen. Um Ihre Anzeige von Kennzahlen zu optimieren, wählen Sie mithilfe der Auswahltaste oben rechts den gewünschten Zeitraum aus, um sich auf bestimmte CPU- und Speicherauslastungsdaten zu konzentrieren.
Anmerkung
Telemetriedaten werden zu Überwachungszwecken bereitgestellt. Die tatsächliche Abrechnung wird auf der Grundlage der gemessenen Nutzungsdaten berechnet und kann aufgrund der Aggregationszeit, der Abstimmungsprozesse und der Messgenauigkeit von den Telemetriewerten abweichen. Die verbindlichen Gebühren entnehmen Sie Ihrer AWS Abrechnung.
Bereitgestellte Span-Daten
Um die Beobachtbarkeit zu verbessern, AgentCore bietet es strukturierte Zeitspannen, die Einblick in die APIs der integrierten Tools bieten. Um diese Span-Daten zu aktivieren, müssen Sie Observability auf Ihrer integrierten Tool-Ressource aktivieren. Schritte und Einzelheiten finden Sie unter Hinzufügen von Observability zu Ihren Amazon AgentCore Bedrock-Ressourcen. Diese Span-Daten sind vollständig in AWS CloudWatch Logs in der aws/spans Protokollgruppe verfügbar. Die folgende Tabelle definiert den Vorgang, für den Spans erstellt werden, und die Attribute für jeden erfassten Bereich.
Code-Interpreter
| Vorgangsname | Span-Attribute | Description |
|---|---|---|
|
StartCodeInterpreterSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Startet eine Code-Interpreter-Sitzung. |
|
StopCodeInterpreterSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Stoppt eine Codeinterpreter-Sitzung. |
|
InvokeCodeInterpreter |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Ruft einen Codeinterpreter mit Eingabecode auf. |
|
CodeInterpreterSessionExpire |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Läuft eine Codeinterpreter-Sitzung ab, wenn StopCodeInterpreterSession sie nicht aufgerufen wird, und die Sitzung läuft ab. |
-
toolsession.id — die ID der Toolsitzung
-
session_duration_s — die Dauer der Sitzung in Sekunden, bevor sie beendet wurde
Browser
| Vorgangsname | Span-Attribute | Description |
|---|---|---|
|
StartBrowserSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Startet eine Browsersitzung. |
|
StopBrowserSession |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Stoppt eine Browsersitzung. |
|
ConnectBrowserAutomationStream |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type |
Stellen Sie eine Connect zu einem Browser-Automatisierungsstream her. |
|
BrowserSessionExpire |
aws.operation.name, aws.resource.arn, aws.request.id, aws.account.id, toolsession.id, aws.xray.origin, aws.resource.type, aws.region, latency_ms, error_type, session_duration_s |
Läuft eine Codeinterpreter-Sitzung ab, wenn StopBrowserSession sie nicht aufgerufen wird, und die Sitzung läuft ab. |
Daten des Anwendungsprotokolls
AgentCore stellt strukturierte Anwendungsprotokolle bereit, die Ihnen helfen, einen Überblick über die Laufzeitaufrufe Ihrer Agenten und den Ressourcenverbrauch auf Sitzungsebene zu erhalten. Diese Protokolldaten werden bereitgestellt, wenn Sie Observability auf Ihrer Agentenressource aktivieren. Schritte und Einzelheiten finden Sie unter Hinzufügen von Observability zu Ihren Amazon AgentCore Bedrock-Ressourcen. AgentCore kann CloudWatch Protokolle in Logs, Amazon S3 oder Firehose Stream ausgeben. Wenn Sie ein CloudWatch Logs-Ziel verwenden, werden diese Protokolle in den Anwendungsprotokollen Ihres Agenten oder in Ihrer eigenen benutzerdefinierten Protokollgruppe gespeichert.
| Protokolltyp | Protokollfelder | Description |
|---|---|---|
|
APPLICATION_LOGS |
timestamp, resource_arn, event_timestamp, account_id, request_id, session_id, trace_id, span_id, service_name, operation, request_payload, response_payload |
Anwendungsprotokolle für mit InvokeCodeInterpreter Tracing-Feldern, Anforderungs- und Antwort-Payloads |
