As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
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 da 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 ao excesso dos limites permitidos de TPS (transações por segundo) ou cota. Essas solicitações retornam ThrottlingException com o código de status HTTP 429.
- SystemErrors
-
O número de erros do lado 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 ser resolvido.
- Latência
-
O tempo decorrido entre o momento em que o serviço recebe a solicitação e o início do envio do 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 ao excesso dos limites permitidos de TPS (transações por segundo) ou cota. Essas solicitações retornam ThrottlingException com o código de status HTTP 429.
- SystemErrors
-
O número de erros do lado 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 ser resolvido.
- Latência
-
O tempo decorrido entre o momento em que o serviço recebe a solicitação e o início do envio do 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 do usuário 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 do 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 nível de conta e nível de 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 em 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 em 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 em nível de conta estão disponíveis no Amazon CloudWatch Bedrock AgentCore Observability Console, na guia Built-in Ferramentas. O painel no console conterá um gráfico de uso de memória e um gráfico de uso da 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 em nível de 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 da 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 em 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 oficiais.
Registros vendidos
O Amazon Bedrock AgentCore Built-in Tools oferece a capacidade de habilitar registros distribuídos para telemetria de uso em nível de sessão com granularidade de 1 segundo. Cada registro de log contém 1 segundo de data de uso de recursos. As métricas atualmente suportadas incluem:
-
Código do Code Interpreter Interpreter.vcpu.hours.used e código _hours.used Interpreter.memory.gb
-
Navegadores browser.vcpu.hours.used e browser.memory.gb_hours.used
Cada dado de uso de recursos usará o esquema a seguir no registro de log.
Intérprete de código
| Tipo de log | Campos de log | Description |
|---|---|---|
|
REGISTROS DE USO |
event_timestamp, resource_arn, service.name, cloud.provider, cloud.region, account.id, region, resource.id, session.id, lapsed_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 |
|---|---|---|
|
REGISTROS 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 ativar 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 de métricas, 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 em 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 oficiais.
Dados de abrangência fornecidos
Para melhorar a observabilidade, AgentCore fornece extensões estruturadas que fornecem visibilidade das APIs de ferramentas integradas. Para habilitar esses dados de abrangência, você precisa ativar a observabilidade em seu recurso de ferramenta incorporado. Consulte Adicionar observabilidade aos seus AgentCore recursos do Amazon Bedrock para obter etapas e detalhes. Esses dados de abrangência estão disponíveis na íntegra em AWS CloudWatch Registros no aws/spans grupo de registros. A tabela a seguir define a operação para a qual os períodos são criados e os atributos de cada período capturado.
Intérprete de código
| Nome da operação | Atributos de extensão | 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 de intérprete 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 de intérprete de código se não StopCodeInterpreterSession for chamada e o tempo limite da 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 extensão | 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 de intérprete de código se não StopBrowserSession for chamada e o tempo limite da sessão expirar. |
Dados de registro do aplicativo
AgentCore fornece registros estruturados de aplicativos que ajudam você a obter visibilidade das invocações do tempo de execução do agente e do consumo de recursos no nível da 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 obter etapas e detalhes. AgentCore pode enviar 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 em 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 |
