View a markdown version of this page

Beobachtbarkeit und Kostenkontrolle - Amazon Grundgestein AgentCore
BeobachtbarkeitCloudTrailKontrollieren Sie die Kosten mit LimitsTags (Markierungen)

Beobachtbarkeit und Kostenkontrolle

Auf dieser Seite erfahren Sie mehr über die Überwachung Ihres Kabelbaums, die Kontrolle der Ausführungskosten und die Verwaltung von Ressourcen-Tags.

Beobachtbarkeit

Bei jedem Harness-Aufruf werden über AgentCore Observability in automatisch Traces, Protokolle und Metriken generiert. CloudWatch Modellaufrufe, Tool-Aufrufe, Speicheroperationen, Shell-Befehle: Jeder Schritt wird mit Informationen zum Zeitpunkt und zur Nutzlast angezeigt. Keine zusätzliche Konfiguration. Traces sind ab dem ersten Aufruf verfügbar.

Beispiel
AWS CLI/boto3

Ablaufverfolgungen, Protokolle und Metriken werden CloudWatch über die Harness-Ausführungsrolle weitergeleitet. Sie können sie im AgentCore Observability-Dashboard anzeigen oder programmgesteuert über die CloudWatch Logs und APIs abfragen. X-Ray

Bevor Sie Traces sehen, aktivieren Sie die Transaktionssuche in CloudWatch (einmalig pro Konto). Einzelheiten zur Einrichtung finden Sie unter Erste Schritte mit AgentCore Observability.

AgentCore CLI
# Stream logs
agentcore logs --harness research-agent

# Filter
agentcore logs --harness research-agent --since 1h --level error

# List recent traces
agentcore traces list --harness research-agent

# Get a specific trace
agentcore traces get <trace-id> --harness research-agent

Weitere Informationen: Überblick über Observability · Metriken · Telemetrie

CloudTrail

Harness-Operationen werden AWS CloudTrail als Managementereignisse (Steuerungsebene) und Datenereignisse (Datenebene) protokolliert. In CloudTrail werden Kabelbaumressourcen unter dem AWS::BedrockAgentCore::Runtime Ressourcentyp und nicht unter einem für den Kabelbaum spezifischen Typ angezeigt. Bei Harness handelt es sich um eine verwaltete Abstraktion über AgentCore Runtime, und CloudTrail Ereignisse spiegeln aus Konsistenzgründen die zugrunde liegende Laufzeitressource wider.

Alle CloudTrail Harness-Ereignisse verwenden resources.type =AWS::BedrockAgentCore::Runtime. Die Namen der Ereignisse lauten:

  • CreateHarness,UpdateHarness, DeleteHarnessGetHarness, ListHarnesses (Verwaltungsereignisse)

  • InvokeAgentRuntime, InvokeAgentRuntimeCommand (Datenereignisse)

Anmerkung

Operationen auf der Datenebene erscheinen als InvokeAgentRuntime und InvokeAgentRuntimeCommand in CloudTrail und entsprechen der zugrunde liegenden Runtime-API. Das resources.ARN Feld enthält den Harness-ARN für Steuerebenenereignisse und den Runtime-ARN für Datenebenenereignisse.

Kontrollieren Sie die Kosten mit Limits

Legen Sie feste Obergrenzen fest, damit ein Mitarbeiter, der nicht in der Lage ist, Ressourcen zu verbrennen:

  • maxIterations- reasoning/action Zyklen pro Aufruf. Standard 75.

  • timeoutSeconds- Timeout bei der Wanduhr für einen einzelnen Aufruf. Standard 3600.

  • maxTokens- Token-Budget pro Aufruf. Standard N/A.

  • idleRuntimeSessionTimeout- wie lange eine MicroVM im Leerlauf warm bleibt. Standard 900.

  • maxLifetime- maximale Lebensdauer einer MicroVM-Sitzung. Standard 28800.

Alle Grenzwerte sind optional. Lassen Sie sie weg, um die Standardwerte des Dienstes zu verwenden. Da Harness von AgentCore Runtime unterstützt wird, unterliegen Harness-Aufrufe auch Runtime-Dienstkontingenten. Weitere Informationen finden Sie unter AgentCore Harness Service Quotas und AgentCore Runtime Service Quotas.

Beispiel
AWS CLI/boto3
aws bedrock-agentcore-control update-harness \
  --harness-id "MyHarness-UuFdkQoXSL" \
  --max-iterations 50 \
  --timeout-seconds 1800 \
  --max-tokens 8192

Oder überschreiben Sie einen einzelnen Aufruf, indem Sie maxIterationstimeoutSeconds, oder maxTokens in invoke_harness übergeben.

AgentCore CLI

Standardwerte festlegen:

agentcore add harness --name bounded-agent \
  --max-iterations 50 --timeout 1800 --max-tokens 8192 \
  --truncation-strategy sliding_window \
  --idle-timeout 600 --max-lifetime 14400
agentcore deploy

Die --truncation-strategy Flagge akzeptiert sliding_window odersummarization. Die --max-lifetime Flags --idle-timeout und legen Lebenszyklusgrenzen in Sekunden fest.

Bei einem einzigen Anruf überschreiben:

agentcore invoke --harness bounded-agent --max-iterations 20 --harness-timeout 600 \
  "Quick lookup: what's the weather in Seattle?"

Tags (Markierungen)

Fügen Sie Ihrem Kabelbaum Kennzeichnungen für die Kostenzuweisung und Zugriffskontrolle hinzu.

Beispiel
AWS CLI/boto3
aws bedrock-agentcore-control create-harness \
  --harness-name "MyHarness" \
  --execution-role-arn "arn:aws:iam::123456789012:role/MyHarnessRole" \
  --tags '{"team": "platform", "environment": "staging"}'
AgentCore CLI

Legen Sie Tags fest inharness.json:

{
  "tags": {
    "team": "platform",
    "environment": "staging"
  }
}

Ausführenagentcore deploy, um sich zu bewerben.

Tags werden zu den bereitgestellten CloudFormation Ressourcen weitergeleitet.

Verwandte Themen