Registro de métricas do agente privado Jitterbit
Introdução
Métricas do agente são mensagens de log de desempenho do agente privado gravadas em um arquivo de log JSON projetado para observabilidade plataformas como DataDog ou ElasticSearch.
Nota
Os logs de métricas do Agente estão disponíveis em agentes privados versão 11.39 ou posterior.
Habilitar logs de métricas do agente
O log de métricas do agente não é habilitado por padrão. Para habilitá-lo, siga estas etapas:
- Edite o arquivo de configuração do agente privado.
- Adicione uma nova seção
[MetricLogging]. - Sob o
[MetricLogging]seção, conjuntoEnableAgentMetricLogging=true. - Reinicie os serviços Jitterbit.
Formato do arquivo de log
Quando habilitado, as métricas do agente são gravadas no JITTERBIT_HOME/log/AgentMetric.log arquivo no formato JSON.
O arquivo contém 3 chaves raiz, como segue:
| Chave | Tipo de dado | Descrição |
|---|---|---|
name | String | Tipo de log. |
timestamp | String | Carimbo de data e hora Unix epoch para a entrada de log. |
fields | String | Chaves e valores de log. |
O valor do name A chave indica o tipo de mensagem de log e quais chaves aparecem no fields chave:
name valor | Descrição do log |
|---|---|
operation_log | O status da operação em cada estágio do seu processamento. |
operation_running_over_scheduled_interval | Indica que a operação está excedendo o cronograma. |
agent_sync_progress | O status da sincronização do ambiente do agente processo. |
agent_sync_file_error | Os detalhes de qualquer falha de download de sincronização de ambiente. |
Exemplos de arquivo de log
name: "operation_log"
Agent successfully scheduled an operation
{
"fields": {
"environment_id": "265580",
"environment_name": "AS-Local-env-1",
"operation_id": "6452590",
"operation_instance_guid": "2cf46ed6-148a-4978-8bfe-dacd1c7a6579",
"operation_name": "New Operation - 3",
"organization_id": "36990",
"project_guid": "5f3b6467-3390-4d3a-a0b2-6d97081ac304",
"project_name": "Test-Charizard",
"status": "SUBMITTED",
"submitted_ts": "2024-12-18T01:13:04.055649"
},
"name": "operation_log",
"timestamp": 1734484384070
}
Operation canceled (by Integration Studio user, or agent restart)
{
"fields": {
"agent_group_id": "228510",
"agent_group_name": "AS-Local-Agent",
"agent_id": "286110",
"agent_name": "As-Local-Agent",
"duration_seconds": "4",
"entered_ts": "2024-12-19T02:34:11.322000",
"environment_id": "265580",
"environment_name": "AS-Local-env-1",
"operation_id": "6452590",
"operation_instance_guid": "40c8f4c8-c389-4711-92d9-c62d8f9b913c",
"operation_name": "New Operation - 3",
"organization_id": "36990",
"project_guid": "5f3b6467-3390-4d3a-a0b2-6d97081ac304",
"project_name": "Test-Charizard",
"started_ts": "2024-12-19T02:34:28.441605",
"status": "CANCELLED",
"status_ts": "2024-12-19T02:34:33.136890"
},
"name": "operation_log",
"timestamp": 1734575673160
}
Operation changed to 'Running' status
{
"fields": {
"agent_group_id": "228510",
"agent_group_name": "AS-Local-Agent",
"agent_id": "286110",
"agent_name": "As-Local-Agent",
"entered_ts": "2024-12-19T02:34:11.322000",
"environment_id": "265580",
"environment_name": "AS-Local-env-1",
"operation_id": "6452590",
"operation_instance_guid": "40c8f4c8-c389-4711-92d9-c62d8f9b913c",
"operation_name": "New Operation - 3",
"organization_id": "36990",
"process_guid": "",
"project_guid": "5f3b6467-3390-4d3a-a0b2-6d97081ac304",
"project_name": "Test-Charizard",
"started_ts": "2024-12-19T02:34:28.441605",
"status": "RUNNING"
},
"name": "operation_log",
"timestamp": 1734575668482
}
Operation changed to final status
{
"fields": {
"agent_group_id": "228510",
"agent_group_name": "AS-Local-Agent",
"agent_id": "286110",
"agent_name": "As-Local-Agent",
"duration_seconds": "4",
"entered_ts": "2024-12-19T02:34:11.322000",
"environment_id": "265580",
"environment_name": "AS-Local-env-1",
"operation_id": "6452590",
"operation_instance_guid": "40c8f4c8-c389-4711-92d9-c62d8f9b913c",
"operation_name": "New Operation - 3",
"organization_id": "36990",
"project_guid": "5f3b6467-3390-4d3a-a0b2-6d97081ac304",
"project_name": "Test-Charizard",
"started_ts": "2024-12-19T02:34:28.441605",
"status": "SUCCESS_WITH_INFO",
"status_ts": "2024-12-19T02:34:33.136890"
},
"name": "operation_log",
"timestamp": 1734575673160
}
name: "operation_running_over_scheduled_interval"
Operation running longer than its scheduled interval
{
"fields": {
"environment_id": "265580",
"environment_name": "AS-Local-env-1",
"is_operation_over_schedule": "true",
"operation_id": "6385330",
"operation_instance_guid": "",
"operation_name": "New Operation",
"organization_id": "36990",
"project_guid": "5f3b6467-3390-4d3a-a0b2-6d97081ac304",
"project_name": "Test-Charizard"
},
"name": "operation_running_over_scheduled_interval",
"timestamp": 1734484381615
}
name: "agent_sync_progress"
{
"name": "agent_sync_progress",
"@timestamp": 1736900182570,
"fields": {
"environmentId": 192660,
"organizationId": 36990,
"totalFiles": 6,
"filesProcessed": 1,
"totalBytes": 0,
"bytesDownloaded": 0,
"fileMetadata": {
"fileId": 61840,
"filename": "org.jitterbit.plugin.pipeline.user.S3Get",
"filesize": 0,
"agentSyncFileType": "FILE_DOWNLOAD"
},
"agentSyncFileDownloadProgress": {
"duration": 39062,
"speed": 0.0,
"timeRemaining": 0.0,
"percentage": 0.0
}
}
}
name: "agent_sync_file_error"
{
"@timestamp": 1736900293034,
"fields": {
"environmentId": 0,
"organizationId": 36990,
"agentSyncFileMetadata": {
"fileId": 5778250,
"filename": "jitterbit-connector-bigcommerce-1.0.0-10170.jar",
"filesize": 0,
"agentSyncFileType": "FILE_DOWNLOAD"
}
},
"name": "agent_sync_file_error"
}