Support-Tools auf privaten Jitterbit-Agenten

Einführung

Die auf dieser Seite beschriebenen Agent Support Tools sind eine Reihe von Diagnose- und Berichtsbefehlen.

Nutzen Sie diese Tools, um die Leistung des Agenten zu überprüfen oder auf Anfrage des Jitterbit-Supports.

Führen Sie die folgenden Befehle aus, um auf die Tools zuzugreifen:

LinuxWindows

cd /opt/jitterbit/AgentSupportTools
./run.sh

cd C:\Program Files\Jitterbit Agent\AgentSupportTools
.\run.bat

Die Tools sind bereit, wenn die Eingabeaufforderung JB Agent Tools> angezeigt wird. Von hier aus können Sie jeden der unten aufgeführten Befehle eingeben.

Tipp

Geben Sie die ersten Zeichen eines Befehls ein und drücken Sie die Tab-Taste, um die entsprechenden Befehle anzuzeigen.

`help`

Beschreibung

Zeigt alle verfügbaren Befehle an.

Verwendung

help [COMMAND]

Optionen

COMMAND: Zeigt die Hilfe für einen Befehl an.

`about`

Hinweis

Hinzugefügt in privater Agent-Version 11.36.

Beschreibung

Zeigt die folgenden Informationen zum installierten Agent an:

Agent-Name
Agent-Gruppe
Version
Umgebungen

Verwendung

about

Optionen

Keine.

`apache-stat`

Beschreibung

Zeigt den Status des Apache-Dienstes an.

Verwendung

apache-stat [-j]

Optionen

-j: Gibt Ergebnisse im JSON-Format zurück.

Beispiele

JB Agent Tools>apache-stat
Busy Workers | Idle Workers | Total Workers | Free Capacity
-----------------------------------------------------------
           1 |          255 |           256 |           99%

JB Agent Tools>apache-stat -j
{
  "busy_workers": 1,
  "idle_workers": 255,
  "total_workers": 256,
  "capacity_percent":99
}

`clear`

Beschreibung

Löscht die Konsole.

Verwendung

clear

Optionen

Keine

`connection-check`

Beschreibung

Überprüft die Verbindungen vom privaten Agent zum Harmony-Gateway sowie die Apache- und Tomcat-Server des privaten Agenten.

Verwendung

connection-check [-t]

Optionen

-t: Falls traceroute installiert ist, wird die Ausgabe für die Harmony-Gateway-Hostadresse einbezogen.

Beispiele

JB Agent Tools>connection-check
connection-check
***** Harmony *****

Ping: na-east.jitterbit.com
Harmony gateway is reachable

***** Apache *****
Apache Is reachable on port 46908

***** Tomcat *****
Tomcat is reachable on port 46912.

`endpointusage-stat`

Hinweis

Hinzugefügt in privater Agent-Version 11.53.

Beschreibung

Zeigt Informationen zur Endpoint-Nutzung an.

Verwendung

endpointusage-stat [-j]

Optionen

-j: Gibt Ergebnisse im JSON-Format zurück.

Beispiele

JB Agent Tools>endpointusage-stat
Endpoint Usage Upload Stats (C++)
--------------------------------
Total Uploaded     : 8
Pending Uploads    : 1
Failed Uploads     : 0

Endpoint Usage Queue Stats (Java)
--------------------------------
Max Size             : 10000
Total Entries        : 0

Endpoint Usage Shipment Stats (Java)
-----------------------------------
Total Shipped        : 11
Total Not Shipped    : 0

JSON output

JB Agent Tools>endpointusage-stat -j
{"endpointUsageJavaQueueDetails":{"maxSize":10000,"totalEntries":0},"endpointUsageUploadDetails":{"totalUploaded":8,"failedUploads":0,"pendingUploads":1},"endpointUsageShipmentDetails":{"totalShipped":11,"totalNotShipped":0}}

`env-list`

Hinweis

Hinzugefügt in privater Agent-Version 11.36.

Beschreibung

Zeigt eine Liste der Umgebungen an, die dem privaten Agent zugeordnet sind.

Verwendung

env-list

Optionen

Keine.

`exit`

Beschreibung

Beendet das Programm.

Verwendung

exit

Optionen

Keine

`generate-report`

Beschreibung

Erstellt die folgenden Dateien:

report.html: Ein Bericht mit den Operationen des Agenten, ausstehenden Operationen, Apache-Statistiken, PostgreSQL-Serververbindungen, Systemprotokolldateien und Diensten.
jitterbit-logs.zip: Eine ZIP-Datei mit den Protokolldateien des privaten Agenten.

Hinweis

Bei privaten Linux-Agenten (einschließlich RPM, Ubuntu, Debian, Docker und Installationen ohne Root-Berechtigung) protokolliert generate-report einen PostgreSQL-Verbindungsfehler (z. B. Connection to 127.0.0.1:5432 refused und Failed to obtain JDBC Connection) und bezieht die PostgreSQL-Daten nicht in report.html ein. Der Bericht und jitterbit-logs.zip werden trotzdem generiert. Windows-Agenten sind nicht betroffen.

Verwendung

generate-report [-p OUTPUT_DIRECTORY]

Optionen

-p OUTPUT_DIRECTORY: Speichert die Dateien im angegebenen Verzeichnis.

`list-connectors`

Beschreibung

Zeigt heruntergeladene und geladene Konnektoren an.

Verwendung

list-connectors [-p AGENT_PORT]

Optionen

-p: Port, auf dem der Agent ausgeführt wird.

Beispiele

JB Agent Tools>list-connectors
list-connectors
---------------------------
Downloaded connectors
---------------------------
SAP - 1.0.0
Smart Recruiters - 1.0.0
Jira - 1.0.1
AI - 1.0.0
SalesforceEvents - 1.0.0

---------------------------
Loaded connectors
---------------------------
SAP - 1.0.0
SalesforceEvents - 1.0.0
CLARIZEN - 1.0.0
FOUR51 - 1.0.0
FOUR51 - 1.0.0
Smart Recruiters - 1.0.0
Jira - 1.0.1
CLARIZEN - 1.0.0
AI - 1.0.0

`list-ops`

Beschreibung

Zeigt Operationen an.

Verwendung

list-ops [-d] [OPERATION_NAME_FILTER]

Optionen

OPERATION_NAME_FILTER: Zeigt Operationen an, die mit diesem Text beginnen. Standard: jb-agent-tools-.
-d: Zeigt weitere Details an.

`log-sync`

Beschreibung

Zeigt die Anzahl der Elemente in der Warteschlange des Private-Agent-Protokolls für jeden der Zustände verarbeitet, unverarbeitet und Fehler an.

Verwendung

log-sync

Optionen

Keine

`pending-ops`

Beschreibung

Zeigt die Anzahl der geplanten und untergeordneten Anfragen in einem laufenden oder wartenden Zustand an.

Verwendung

pending-ops [-j]

Optionen

-j: Gibt Ergebnisse im JSON-Format zurück.

`pg-connection`

Beschreibung

Zeigt den Status offener PostgreSQL-Verbindungen an.

Verwendung

pg-connection [ -m MODE] [-j]

Optionen

-m MODE: Wählt die Verbindungsmethode, wobei MODE einer der folgenden Werte ist:
- conf: Verwendet die Informationen in der Datei jitterbit.conf.
- postgres: Verbindung zum PostgreSQL-Server.
- pgbouncer: Verbindung zum Service pgbouncer.
-j: Gibt Ergebnisse im JSON-Format zurück.

Beispiele

JB Agent Tools>pg-connection
pg-connection
count | state
---------------
    5 | null
    1 | active
   12 | idle

JB Agent Tools>pg-connection -j
pg-connection -j
[{"count":5,"state":null},{"count":1,"state":"active"},{"count":13,"state":"idle"}]

`pg-status`

Beschreibung

Zeigt die Datenbankgröße an und listet Tabellen mit der höchsten Anzahl von Tabellenscans und betroffenen Zeilen auf.

Verwendung

pg-status

Optionen

Keine

Beispiele

JB Agent Tools>pg-status
pg-status
                     Table |       Scans (Sequential-Index) | Affected rows (Inserted-Updated-Deleted)
-----------------------------------------------------------------------------------------------------
            incomingmsgtab |              317439 (7-317432) |                  44 (15-14-15)
       verboseloguploadtab |                21450 (3-21447) |                      0 (0-0-0)
                key_values |              18797 (18177-620) |               1081 (11-1069-1)
                logsynctab |             16194 (13318-2876) |              330 (110-110-110)
              deploylogtab |                   312 (21-291) |              674 (230-229-215)
   operationdataelementtab |                     32 (20-12) |                752 (376-0-376)
   document_definitionstab |                        5 (5-0) |                592 (296-0-296)
    filestorepropertiestab |                        9 (7-2) |                408 (204-0-204)
 transformationdefinitionstab |                      17 (17-0) |                400 (200-0-200)
    operationpropertiestab |                      34 (34-0) |                344 (180-0-164)
-----------------------------------------------------------------------------------------------------

Database size: 16 MB

`resync-deploylogs`

Hinweis

Hinzugefügt in Private-Agent-Version 11.29.

Beschreibung

Lädt die Bereitstellungsprotokolle von Harmony herunter, um sie für eine bestimmte Umgebungs-ID erneut zu synchronisieren.

Verwendung

resync-deploylogs -e ENVIRONMENT_ID [-p AGENT_PORT]

Optionen

-e: Umgebungs-ID.
-p: Agent-Portnummer.

`run-op`

Beschreibung

Führt eine Operation anhand ihrer ID aus und zeigt dann den Status an.

Verwendung

run-op [-l OPERATION_ID LOOP_COUNT] [-r OPERATION_ID DELAY] [-s OPERATION_ID]

Optionen

-l: Führt die Operation OPERATION_ID LOOP_COUNT-mal aus.
-r: Führt die Operation OPERATION_ID in einer Endlosschleife mit einer Verzögerung zwischen den Ausführungen aus.
-s: Stoppt die Endlosschleife der Operation OPERATION_ID.

`service-status`

Beschreibung

Zeigt den Status der Agent-Services Apache, Tomcat, Postgres, Pgbouncer und VerboseLogShipper an.

Verwendung

service-status

Optionen

Keine

`zip-logs`

Beschreibung

Erstellt eine ZIP-Datei mit allen Agent-Protokollen.

Verwendung

zip-logs [OUTPUT_DIRECTORY]

Optionen

OUTPUT_DIRECTORY: Speichert die Datei .zip im angegebenen Verzeichnis.

Beispiele

JB Agent Tools>zip-logs
zip-logs
Zip filed created in: /opt/jitterbit/AgentSupportTools/jitterbit-logs.zip

JB Agent Tools>zip-logs /var
zip-logs /var
Zip filed created in: /var/jitterbit-logs.zip