Ir para o conteúdo

Ferramentas de suporte em agentes privados Jitterbit

Introdução

As Ferramentas de Suporte do Agente descritas nesta página são um conjunto de comandos de diagnóstico e relatório.

Use-as para ver como seu agente está se saindo ou quando solicitado pelo suporte da Jitterbit.

Para acessar as ferramentas, execute os seguintes comandos:

cd /opt/jitterbit/AgentSupportTools
./run.sh
cd C:\Program Files\Jitterbit Agent\AgentSupportTools
.\run.bat

As ferramentas estão prontas quando você vê o prompt JB Agent Tools>. A partir daqui, você pode inserir qualquer um dos comandos listados abaixo.

Dica

Digite os primeiros caracteres de um comando e pressione a tecla Tab para ver aqueles que correspondem.

help

Descrição

Mostra todos os comandos disponíveis.

Uso

help [COMMAND]

Opções

  • COMMAND: Mostra ajuda para um comando.

about

Nota

Adicionado na versão 11.36 do agente privado.

Descrição

Mostra as seguintes informações sobre o agente instalado:

  • Nome do agente
  • Grupo do agente
  • Versão
  • Ambientes

Uso

about

Opções

Nenhuma.

apache-stat

Descrição

Mostra o status do serviço Apache.

Uso

apache-stat [-j]

Opções

  • -j: Retorna resultados em formato JSON.

Exemplos

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

Descrição

Limpa o console.

Uso

clear

Opções

Nenhuma

connection-check

Descrição

Verifica as conexões do agente privado com o gateway Harmony e os servidores Apache e Tomcat do agente privado.

Uso

connection-check [-t]

Opções

  • -t: Se traceroute estiver instalado, inclui sua saída para o endereço do host do gateway Harmony.

Exemplos

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

Adicionado na versão 11.53 do agente privado.

Descrição

Mostra informações sobre o uso do endpoint.

Uso

endpointusage-stat [-j]

Opções

  • -j: Retorna resultados no formato JSON.

Exemplos

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
Saída 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

Adicionado na versão 11.36 do agente privado.

Descrição

Mostra uma lista de ambientes associados ao agente privado.

Uso

env-list

Opções

Nenhuma.

exit

Descrição

Sai do programa.

Uso

exit

Opções

Nenhuma

generate-report

Descrição

Cria os seguintes arquivos:

  • report.html: Um relatório mostrando as operações do agente, operações pendentes, estatísticas do Apache, conexões do servidor PostgreSQL, arquivos de log do sistema e serviços.
  • jitterbit-logs.zip: Um arquivo zip contendo arquivos de log do agente privado.

Uso

generate-report [-p OUTPUT_DIRECTORY]

Opções

  • -p OUTPUT_DIRECTORY: Salva os arquivos no diretório especificado.

list-connectors

Descrição

Mostra conectores baixados e carregados.

Uso

list-connectors [-p AGENT_PORT]

Opções

  • -p: Porta em que o agente está rodando.

Exemplos

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

Descrição

Mostra operações.

Uso

list-ops [-d] [FILTRAR_NOME_OPERACAO]

Opções

  • FILTRAR_NOME_OPERACAO: Mostra operações que começam com este texto. Padrão: jb-agent-tools-.

  • -d: Mostra mais detalhes.

log-sync

Descrição

Mostra o número de itens na fila de log do agente privado para cada um dos estados processados, não processados e erro.

Uso

log-sync

Opções

Nenhuma

pending-ops

Descrição

Mostra o número de solicitações agendadas e filhas em um estado em execução ou aguardando.

Uso

pending-ops [-j]

Opções

  • -j: Retorna resultados em formato JSON.

pg-connection

Descrição

Mostra o status das conexões PostgreSQL abertas.

Uso

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

Opções

  • -m MODO: Escolha como fazer a conexão, onde MODO é um dos seguintes:

    • conf: Use as informações no arquivo jitterbit.conf.
    • postgres: Conecte-se ao servidor PostgreSQL.
    • pgbouncer: Conecte-se ao serviço pgbouncer.
  • -j: Retorna resultados em formato JSON.

Exemplos

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

Descrição

Mostra o tamanho do banco de dados e lista as tabelas com o maior número de varreduras de tabela e linhas afetadas.

Uso

pg-status

Opções

Nenhuma

Exemplos

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

Adicionado na versão 11.29 do agente privado.

Descrição

Baixa os logs de implantação do Harmony para re-sincronizá-los para um determinado ID de ambiente.

Uso

resync-deploylogs -e ID_AMBIENTE [-p PORTA_AGENTE]

Opções

  • -e: ID do ambiente.

  • -p: Número da porta do agente.

run-op

Descrição

Execute uma operação especificada pelo seu ID e, em seguida, mostre o status.

Uso

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

Opções

  • -l: Por LOOP_COUNT vezes, execute a operação OPERATION_ID.

  • -r: Execute a operação OPERATION_ID em um loop infinito com um atraso entre as execuções.

  • -s: Pare a operação em loop infinito OPERATION_ID.

service-status

Descrição

Mostre o status dos serviços dos agentes Apache, Tomcat, Postgres, Pgbouncer e VerboseLogShipper.

Uso

service-status

Opções

Nenhuma

zip-logs

Descrição

Crie um arquivo zip contendo todos os logs do agente.

Uso

zip-logs [OUTPUT_DIRECTORY]

Opções

  • OUTPUT_DIRECTORY: Salve o arquivo .zip no diretório especificado.

Exemplos

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