Saltar al contenido

Herramientas de soporte en agentes privados de Jitterbit

Introducción

Las herramientas de soporte para agentes descritas en esta página son un conjunto de comandos de diagnóstico e informes.

Úselas para ver cómo está funcionando su agente, o cuando lo solicite el soporte de Jitterbit.

Para acceder a las herramientas, ejecute los siguientes comandos:

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

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

Las herramientas están listas cuando vea el aviso JB Agent Tools>. Desde aquí puede ingresar cualquiera de los comandos que se enumeran a continuación.

Consejo

Ingrese los primeros caracteres de un comando y luego presione la tecla Tab para ver aquellos que coinciden.

help

Descripción

Muestra todos los comandos disponibles.

Uso

help [COMMAND]

Opciones

  • COMMAND: Muestra ayuda para un comando.

about

Nota

Agregado en la versión 11.36 del agente privado.

Descripción

Muestra la siguiente información sobre el agente instalado:

  • Nombre del agente
  • Grupo del agente
  • Versión
  • Entornos

Uso

about

Opciones

Ninguna.

apache-stat

Descripción

Muestra el estado del servicio Apache.

Uso

apache-stat [-j]

Opciones

  • -j: Devuelve resultados en formato JSON.

Ejemplos

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

Descripción

Limpia la consola.

Uso

clear

Opciones

Ninguna

connection-check

Descripción

Verifica las conexiones desde el agente privado hacia el gateway de Harmony, y los servidores Apache y Tomcat del agente privado.

Uso

connection-check [-t]

Opciones

  • -t: Si traceroute está instalado, incluye su salida para la dirección del host del gateway de Harmony.

Ejemplos

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

Nota

Agregado en la versión 11.53 del agente privado.

Descripción

Muestra información sobre el uso del endpoint.

Uso

endpointusage-stat [-j]

Opciones

  • -j: Devuelve resultados en formato JSON.

Ejemplos

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
Salida JSON
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

Nota

Agregado en la versión 11.36 del agente privado.

Descripción

Muestra una lista de entornos asociados con el agente privado.

Uso

env-list

Opciones

Ninguna.

exit

Descripción

Salir del programa.

Uso

exit

Opciones

Ninguna

generate-report

Descripción

Crea los siguientes archivos:

  • report.html: Un informe que muestra las operaciones del agente, operaciones pendientes, estadísticas de Apache, conexiones al servidor PostgreSQL, archivos de registro del sistema y servicios.
  • jitterbit-logs.zip: Un archivo zip que contiene archivos de registro del agente privado.

Uso

generate-report [-p OUTPUT_DIRECTORY]

Opciones

  • -p OUTPUT_DIRECTORY: Guarda los archivos en el directorio especificado.

list-connectors

Descripción

Muestra conectores descargados y cargados.

Uso

list-connectors [-p AGENT_PORT]

Opciones

  • -p: Puerto en el que se ejecuta el agente.

Ejemplos

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

Descripción

Muestra operaciones.

Uso

`list-ops [-d] [FILTRAR_NOMBRE_OPERACION]`


### Opciones {: #options }

-   `FILTRAR_NOMBRE_OPERACION`: Mostrar operaciones que comienzan con este texto. Predeterminado: `jb-agent-tools-`.

-   `-d`: Mostrar más detalles.


## `log-sync` {: #log-sync }


### Descripción {: #description }

Mostrar el número de elementos en la cola de registro del agente privado para cada uno de los estados procesados, no procesados y con error.


### Uso {: #usage }

`log-sync`


### Opciones {: #options }

Ninguna


## `pending-ops` {: #pending-ops }


### Descripción {: #description }

Mostrar el número de solicitudes programadas e hijas en un estado de ejecución o espera.


### Uso {: #usage }

`pending-ops [-j]`


### Opciones {: #options }

-   `-j`: Devolver resultados en formato JSON.


## `pg-connection` {: #pg-connection }


### Descripción {: #description }

Mostrar el estado de las conexiones PostgreSQL abiertas.


### Uso {: #usage }

`pg-connection [ -m MODO] [-j]`


### Opciones {: #options }

-   `-m MODO`: Elegir cómo hacer la conexión, donde `MODO` es uno de los siguientes:

    -   `conf`:  Usar la información en el archivo `jitterbit.conf`.
    -   `postgres`: Conectar al servidor PostgreSQL.
    -   `pgbouncer`: Conectar al servicio `pgbouncer`.

-   `-j`: Devolver resultados en formato JSON.


### Ejemplos {: #examples }

```txt
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

Descripción

Mostrar el tamaño de la base de datos y listar las tablas con el mayor número de escaneos de tabla y filas afectadas.

Uso

pg-status

Opciones

Ninguna

Ejemplos

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

Nota

Agregado en la versión 11.29 del agente privado.

Descripción

Descargar los registros de implementación de Harmony para re-sincronizarlos para un ID de entorno dado.

Uso

resync-deploylogs -e ID_ENTORNO [-p PUERTO_AGENTE]

Opciones

  • -e: ID de entorno.

  • -p: Número de puerto del agente.

run-op

Descripción

Ejecuta una operación especificada por su ID y luego muestra el estado.


### Uso {: #usage }

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


### Opciones {: #options }

-   `-l`: Durante `LOOP_COUNT` número de veces, ejecuta la operación `OPERATION_ID`.

-   `-r`: Ejecuta la operación `OPERATION_ID` en un bucle infinito con un retraso entre ejecuciones.

-   `-s`: Detiene la operación en bucle infinito `OPERATION_ID`.


## `service-status` {: #service-status }


### Descripción {: #description }

Muestra el estado de los servicios de agentes Apache, Tomcat, Postgres, Pgbouncer y VerboseLogShipper.


### Uso {: #usage }

`service-status`


### Opciones {: #options }

Ninguna


## `zip-logs` {: #zip-logs }


### Descripción {: #description }

Crea un archivo zip que contiene todos los registros de los agentes.


### Uso {: #usage }

`zip-logs [OUTPUT_DIRECTORY]`


### Opciones {: #options }

-   `OUTPUT_DIRECTORY`: Guarda el archivo `.zip` en el directorio especificado.


### Ejemplos {: #examples }

```txt
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