Jitterbit Private Agent-Observabilitätsprotokoll

Einführung

Wenn aktiviert, werden die Metriken der Private Agent-Observabilität durch den Inhalt der Datei AgentMetric.log befüllt. Diese befindet sich im Protokollverzeichnis, standardmäßig C:\Program Files\Jitterbit Agent\log unter Microsoft Windows, /opt/jitterbit/log unter Linux und Docker.

Private Agent-Observabilität aktivieren

Die Private Agent-Observabilität ist standardmäßig nicht aktiviert. Um sie zu aktivieren, befolgen Sie diese Schritte:

Bearbeiten Sie die Konfigurationsdatei des privaten Agents.
Setzen Sie im Abschnitt [AgentCapability] mindestens EnhancedCapabilityMetricsEnabled=true und EnhancedCapabilityMetricsSubmissionEnabled=true und aktivieren Sie alle anderen erforderlichen Metriken.
Starten Sie die Jitterbit-Dienste neu.

Wichtig

Dies aktiviert nur den Dienst zur Protokollerstellung. Sie müssen auch eine Observabilitätsplattform konfigurieren, um das Protokoll zu konsumieren.

Protokolldateiformat

Der Inhalt der Metrikdatei zur Private Agent-Observabilität ist im JSON-Format. Die Datei enthält 3 Wurzel-Schlüssel, wie folgt:

Schlüssel	Datentyp	Beschreibung
`name`	String	Protokolltyp.
`timestamp`	String	Unix-Epoch-Zeitstempel für den Protokolleintrag.
`fields`	String	Protokollschlüssel und -werte.

Der Wert des Schlüssels name gibt den Typ der Protokollnachricht an und welche Schlüssel im Schlüssel fields erscheinen:

`name`-Wert	Protokollbeschreibung
`operation_log`	Der Status der Operation in jeder Phase ihrer Verarbeitung.
`operation_running_over_scheduled_interval`	Gibt an, dass die Operation über dem Zeitplan läuft.
`agent_sync_progress`	Der Status des Umgebungs-Synchronisierungs Prozesses des Agents.
`agent_sync_file_error`	Die Details zu einem Fehler beim Herunterladen der Umgebungs-Synchronisierung.

Protokolldatei-Beispiele

`name: "operation_log"`

Agent hat eine Operation erfolgreich geplant

{
    "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 abgebrochen (durch Studio-Benutzer oder Agenten-Neustart)

{
    "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 auf 'Läuft'-Status geändert

{
    "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 auf endgültigen Status geändert

{
    "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 läuft länger als ihr geplanter Zeitraum

{
    "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"
}