AgentCore dados de observabilidade de ferramentas integradas gerados
Tópicos
Métricas de ferramentas de observabilidade
AgentCore fornece as seguintes métricas integradas para o interpretador de código e as ferramentas do navegador. Built-in as métricas da ferramenta são agrupadas em intervalos de um minuto. Para saber mais sobre AgentCore ferramentas, consulte Executar código e analisar dados usando o Amazon Bedrock AgentCore Code Interpreter e interagir com aplicativos web usando o Amazon Bedrock AgentCore Browser.
Ferramenta de invocação:
- Invocations
-
O número total de solicitações feitas à API Data Plane. Cada chamada de API conta como uma invocação, independentemente do tamanho da carga útil da solicitação ou do status da resposta.
- Controles de utilização
-
O número de solicitações limitadas pelo serviço devido à superação dos limites permitidos de TPS (transações por segundo) ou de cota. Essas solicitações retornam ThrottlingException com o código de status HTTP 429.
- SystemErrors
-
O número de erros do servidor encontrados durante o processamento da solicitação.
- UserErrors
-
O número de erros do lado do cliente resultantes de solicitações inválidas. Isso requer ação do usuário para resolver.
- Latência
-
O tempo decorrido entre o momento em que o serviço recebe a solicitação e o momento em que ele começa a enviar o primeiro token de resposta. Importante para medir o tempo de resposta inicial.
Crie uma sessão de ferramentas:
- Invocations
-
O número total de solicitações feitas à API Data Plane. Cada chamada de API conta como uma invocação, independentemente do tamanho da carga útil da solicitação ou do status da resposta.
- Controles de utilização
-
O número de solicitações limitadas pelo serviço devido à superação dos limites permitidos de TPS (transações por segundo) ou de cota. Essas solicitações retornam ThrottlingException com o código de status HTTP 429.
- SystemErrors
-
O número de erros do servidor encontrados durante o processamento da solicitação.
- UserErrors
-
O número de erros do lado do cliente resultantes de solicitações inválidas. Isso requer ação do usuário para resolver.
- Latência
-
O tempo decorrido entre o momento em que o serviço recebe a solicitação e o momento em que ele começa a enviar o primeiro token de resposta. Importante para medir o tempo de resposta inicial.
- Duração
-
A duração da sessão da ferramenta (a operação se torna CodeInterpreterSession/BrowserSession).
Aquisição de usuários do navegador:
- TakerOverCount
-
O número total de usuários assumindo o controle
- TakerOverReleaseCount
-
O número total de usuários liberando o controle
- TakerOverDuration
-
A duração da aquisição pelo usuário
Métricas e registros de uso de recursos
O Amazon Bedrock AgentCore Built-in Tools fornece telemetria abrangente de uso de recursos, incluindo métricas de consumo de CPU e memória para seus recursos de tempo de execução.
nota
Os dados de uso de recursos podem ser atrasados em até 60 minutos e a precisão pode diferir entre as métricas.
Métricas vendidas
Por padrão, a Bedrock AgentCore Built-in Tools vende métricas para o nível da conta e do nível da ferramenta com resolução de 1 minuto. A CloudWatch agregação e a retenção de dados métricos da Amazon seguem as políticas padrão de retenção CloudWatch de dados da Amazon. Para obter mais informações, consulte https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_concepts.html#Metric.
| Nome | Dimensões | Description |
|---|---|---|
|
CPUUsed-vCPUHours |
Serviço; Serviço, recurso |
A quantidade total de CPU virtual consumida na CPU-Hours unidade v, disponível no nível do recurso e da conta. Útil para rastreamento de recursos e visibilidade estimada do faturamento. |
|
MemoryUsed-GBHours |
Serviço; Serviço, recurso |
A quantidade total de memória consumida na GB-Hours unidade, disponível nos níveis de recursos e contas. Útil para rastreamento de recursos e visibilidade estimada do faturamento. |
Explicação da dimensão
-
Serviço - AgentCore.CodeInterpreter ou AgentCore.Browser
-
Recurso - ID da Built-in ferramenta
As métricas do nível da conta estão disponíveis no console de AgentCore observabilidade do Amazon CloudWatch Bedrock, na guia Built-in Ferramentas. O painel no console conterá um gráfico de uso de memória e um gráfico de uso de CPU gerado a partir das métricas de uso. Esses gráficos representam o uso total de recursos em todas as ferramentas do tipo de ferramenta selecionado na conta na região.
As métricas do nível da ferramenta estão disponíveis na página Ferramentas do Amazon CloudWatch Bedrock AgentCore Observability Console. O painel no console conterá um gráfico de uso de memória e um gráfico de uso de CPU gerado a partir das métricas de uso. Os gráficos representam o uso total de recursos em todas as sessões da ferramenta selecionada.
nota
Os dados de telemetria são fornecidos para fins de monitoramento. O faturamento real é calculado com base nos dados de uso medidos e pode diferir dos valores de telemetria devido ao tempo de agregação, aos processos de reconciliação e à precisão da medição. Consulte seu extrato de AWS cobrança para ver as cobranças autorizadas.
Registros vendidos
O Amazon Bedrock AgentCore Built-in Tools fornece a capacidade de habilitar registros vendidos para telemetria de uso em nível de sessão com granularidade de 1 segundo. Cada registro de log contém 1 segundo de dados de uso de recursos. As métricas atualmente suportadas incluem:
-
Código do interpretador de código Interpreter.vcpu.hours.used e código _hours.used Interpreter.memory.gb
-
Navegador browser.vcpu.hours.used e browser.memory.gb_hours.used
Cada datum de uso do recurso usará o esquema a seguir no registro de log.
Interpretador de código
| Tipo de log | Campos de log | Description |
|---|---|---|
|
LOGS_DE_USO |
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 |
Registros de uso de recursos para rastreamento de recursos em nível de sessão. |
Navegador
| Tipo de log | Campos de log | Description |
|---|---|---|
|
LOGS_DE_USO |
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 |
Registros de uso de recursos para rastreamento de recursos em nível de sessão. |
Para obter mais informações sobre como habilitar registros, consulte Adicionar observabilidade aos seus recursos do Amazon Bedrock AgentCore . Esses registros são então exibidos no destino conforme configurado (AWS LogGroup, Amazon S3 ou Amazon Kinesis Firehose).
Na página Built-in Tools Session do Amazon CloudWatch Bedrock AgentCore Observability Console, você pode ver as métricas de uso de recursos geradas a partir desses registros. Para otimizar sua experiência de visualização métrica, selecione o intervalo de tempo desejado usando o seletor no canto superior direito para se concentrar em dados específicos de uso da CPU e da memória.
nota
Os dados de telemetria são fornecidos para fins de monitoramento. O faturamento real é calculado com base nos dados de uso medidos e pode diferir dos valores de telemetria devido ao tempo de agregação, aos processos de reconciliação e à precisão da medição. Consulte seu extrato de AWS cobrança para ver as cobranças autorizadas.
Dados de amplitude fornecidos
Para aprimorar a observabilidade, AgentCore fornece extensões estruturadas que fornecem visibilidade das APIs de ferramentas integradas. Para habilitar esses dados de amplitude, você precisa habilitar a observabilidade em seu recurso de ferramenta incorporado. Consulte Adicionar observabilidade aos seus AgentCore recursos do Amazon Bedrock para ver etapas e detalhes. Esses dados de extensão estão disponíveis na íntegra em AWS CloudWatch Logs no grupo de aws/spans registros. A tabela a seguir define a operação para a qual as extensões são criadas e os atributos de cada extensão capturada.
Interpretador de código
| Nome da operação | Atributos de amplitude | 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 |
Inicia uma sessão de intérprete de código. |
|
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 |
Interrompe uma sessão do interpretador de código. |
|
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 |
Invoca um interpretador de código com código de entrada. |
|
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 |
Expira uma sessão do interpretador de código se não StopCodeInterpreterSession for chamada e a sessão expirar. |
-
toolsession.id - o id da sessão da ferramenta
-
session_duration_s - a duração da sessão em segundos antes de terminar
Navegador
| Nome da operação | Atributos de amplitude | 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 |
Inicia uma sessão do navegador. |
|
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 |
Interrompe uma sessão do navegador. |
|
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 |
Conecte-se a um stream de automação do navegador. |
|
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 |
Expira uma sessão do interpretador de código se não StopBrowserSession for chamada e a sessão expirar. |
Dados de registro do aplicativo
AgentCore fornece registros estruturados de aplicativos que ajudam você a obter visibilidade das invocações de tempo de execução do agente e do consumo de recursos em nível de sessão. Esses dados de registro são fornecidos ao ativar a observabilidade em seu recurso de agente. Consulte Adicionar observabilidade aos seus AgentCore recursos do Amazon Bedrock para ver etapas e detalhes. AgentCore pode gerar registros para CloudWatch Logs, Amazon S3 ou Firehose stream. Se você usa um destino de CloudWatch registros, esses registros são armazenados nos registros do aplicativo do seu agente ou no seu próprio grupo de registros personalizado.
| Tipo de log | Campos de log | Description |
|---|---|---|
|
LOGS_DE_APLICATIVOS |
timestamp, resource_arn, event_timestamp, account_id, request_id, session_id, trace_id, span_id, service_name, operação, request_payload, response_payload |
Registros de aplicativos InvokeCodeInterpreter com campos de rastreamento, cargas úteis de solicitação e resposta |
