Arquivo de configuração do agente privado Jitterbit jitterbit.conf
Introdução
Esta página descreve o arquivo de configuração principal para agentes privados, jitterbit.conf. Ele está localizado no diretório de instalação (JITTERBIT_HOME), por padrão C:\Program Files\Jitterbit Agent\ no Microsoft Windows, /opt/jitterbit/ no Linux e Docker.
O arquivo usa o formato [arquivo INI], no qual os nomes das seções ficam entre colchetes e cada seção é uma lista de pares chave-valor. As seções podem estar em qualquer ordem no arquivo. (Esta página ordena as seções alfabeticamente, mas não estão assim no arquivo padrão.) Se houver seções ou chaves não encontradas no seu arquivo, é necessário adicioná-las; algumas não são fornecidas no arquivo padrão. Para chaves não presentes ou comentadas (com um # no início), o valor padrão se aplica. Valores booleanos podem ser fornecidos como 0/1 ou false/true. Os caminhos usam barras invertidas, mesmo ao especificar locais do Windows.
Importante
As alterações feitas no arquivo não são aplicadas até que o agente seja reiniciado e não são sobrescritas ao fazer upgrade.
[AgentCapability]
Estas configurações se aplicam aos recursos de observabilidade dos agentes privados nativos e de terceiros.
As métricas de uso de memória são coletadas apenas em agentes Windows. Em agentes Linux, o uso de memória não é usado no cálculo de capacidade e as configurações de memória nesta seção não têm efeito.
O Apache atende apenas solicitações de API, portanto as configurações de thread do Apache nesta seção são relevantes apenas em um agente que trata APIs.
Quando as métricas de uso de CPU ou memória estão ativadas, elas substituem as outras entradas de capacidade: se alguma delas ultrapassar seu limite, o agente relata como incapaz independentemente da disponibilidade de thread do Apache ou de thread de trabalho do mecanismo de processamento.
Importante
Não altere nenhum valor nesta seção a menos que instruído pelo suporte Jitterbit.
| Chave | Padrão | Descrição |
|---|---|---|
ApacheThreadBuffer |
10 |
Buffer de limite de thread do Apache. |
ApacheThreadCapabilityDebugOutput |
false |
Se true, saída de logs de solução de problemas do Apache adicionais. |
ApacheThreadCapabilityEnabled |
false |
Se true, ativa a métrica de uso de thread do Apache para determinar o status de capacidade do agente. |
ApacheThreadCapabilityReportInterval |
2 |
Com que frequência verificar o uso de thread do Apache (segundos). |
CapabilityDebugOutput |
false |
Se true, saída de logs de solução de problemas de capacidade adicionais. |
CapabilityRefreshCooldown |
1 |
Depois que um agente entra em status incapaz, o período de espera (segundos) antes de atualizar o status de capacidade. Padrão alterado de 2 para 1 na versão 12.7 do agente. |
CpuConsecutiveFailureThreshold |
3 |
Número de violações consecutivas de limite de CPU necessárias antes que o agente mude de capaz para incapaz. Aplica-se apenas quando CpuUsageCapabilityEnabled é true. Padrão alterado de 1 para 3 na versão 12.7 do agente. |
CpuUsageCapabilityDebugOutput |
false |
Se true, ativa logs de debug de capacidade de CPU no arquivo de log do mecanismo de processamento. Se false, apenas registra alterações no status de capacidade de CPU. |
CpuUsageCapabilityEnabled |
false |
Se true, ativa a métrica IncapableCpuUsage para determinar o status de capacidade do agente. |
CpuUsageCapabilityReportInterval |
1 |
Com que frequência verificar a porcentagem de CPU (segundos). |
EnhancedCapabilityMetricsEnabled |
false |
Se true, ativa a lógica de métrica de capacidade do agente. |
EnhancedCapabilityMetricsJMXEnabled |
true |
Se true, ativa a métrica JMX para capacidade. |
EnhancedCapabilityMetricsSubmissionEnabled |
false |
Se true, define EnhancedCapabilityMetricsEnabled como true e envia métricas de capacidade para o Harmony. |
IncapableCpuUsage |
95 |
Porcentagem de CPU na qual o agente fica incapaz. Ignorado a menos que CpuUsageCapabilityEnabled seja true. |
IncapableMemoryUsage |
95 |
Porcentagem de memória na qual o agente fica incapaz. Ignorado a menos que MemoryUsageCapabilityEnabled seja true. |
MemoryUsageCapabilityDebugOutput |
false |
Se true, saída de logs de solução de problemas de memória adicionais. |
MemoryUsageCapabilityEnabled |
false |
Se true, ativa a métrica IncapableMemoryUsage para determinar o status de capacidade do agente. |
MemoryUsageCapabilityReportInterval |
1 |
Com que frequência verificar a porcentagem de memória (segundos). |
[AgentMetrics]
Estas configurações se aplicam apenas ao recurso de observabilidade nativa.
| Chave | Padrão | Descrição |
|---|---|---|
Enabled |
false |
Se true, permite o uso de outras chaves nesta seção. Se false, os valores de outras chaves nesta seção são ignorados. |
JitterbitMetricsServiceEnabled |
false |
Se true, inicia o serviço de coleta de métricas. |
UserIntentFileWatcherEnabled |
true |
Se true e tanto Enabled quanto JitterbitMetricsServiceEnabled forem true, inicia um serviço de monitoramento de arquivo que captura a ação mais recente do usuário. |
OperationStatusLogToFileEnabled |
false |
Se true, registra o status das operações em um arquivo. (Movido e renomeado de EnableAgentMetricLogging em [MetricLogging].) |
OperationStatusLogToFileAsyncEnabled |
true |
Se true e OperationStatusLogToFileEnabled for true, registra de forma assíncrona usando threads separadas. (Movido e renomeado de EnableAgentMetricLogging em [MetricLogging]) Não altere a menos que instruído pelo suporte Jitterbit. |
AgentEnvSyncProgressToFileEnabled |
false |
Se true, registra o processo de sincronização do agent em um arquivo. (Movido e renomeado de EnableAgentSyncMetricLogging em [MetricLogging].) |
SchedulerMetricThreads |
100 |
Tamanho do pool de threads do agendador de métricas. |
ProcessEngineMetricThreads |
Valor de MaxNumberOfWorkerThreads em [ProcessEngine] |
Tamanho do pool de threads do mecanismo de processo de métricas. |
OperationEngineMetricThreads |
(Nenhum) | Se RunOperationsInSeparateProcess=true, usa essa quantidade de threads do pool de threads. |
[APIInfo]
Esta configuração se aplica a operações acionadas por uma OData API do API Manager.
| Chave | Padrão | Descrição |
|---|---|---|
DebugJDML |
false |
Se true, permite registros adicionais de chamadas de OData API no API Manager, incluindo SQL enviado ao banco de dados. |
[APIOperation]
Essas configurações se aplicam a operações acionadas por uma API personalizada ou OData API do API Manager.
| Key | Default | Description |
|---|---|---|
EnableErrorLogging |
true |
Registra apenas erros de operação de API nos logs de operação. Ignorado se EnableLogging é true. |
EnableLogging |
false |
Registra todas as operações acionadas pela API (bem-sucedidas e malsucedidas) nos logs de operação. Isso oferece controle em nível de agente semelhante ao log de debug de operação em operações individuais. Se true, tem precedência sobre EnableErrorLogging. Para mais detalhes sobre logs de operação de API, consulte Dados de solicitação e resposta de API. |
EnableOperationIdLogging |
false |
Registra o ID de uma operação que causa uma falha. |
APIOperationLogging |
false |
Registra a hora de início e o tempo decorrido de uma chamada de API. Caution Turning on this setting generates at least four additional lines for each API operation, which can result in very large log files. |
[AutoScaling]
| Key | Default | Description |
|---|---|---|
DeregisterAgentOnDrainstop |
false |
Remove o registro do agente quando este para. Equivalente a deregisterAgentOnDrainstop em register.json. |
DeregisterAgentOnJVMShutdown |
true |
Desativa o cancelamento de registro no desligamento da JVM se o cancelamento de registro estiver ativado via registro automático ou DeregisterAgentOnDrainstop. |
[ConnectorsInfo]
| Key | Default | Description |
|---|---|---|
MSAXUrl |
http://127.0.0.1:8002/AX/ |
Usado pelo conector Microsoft Dynamics AX Connector. Não altere a menos que instruído pelo suporte Jitterbit. |
MSCrmUrl |
http://127.0.0.1:8000/CRM/ |
Usado pelo conector Microsoft Dynamics CRM Connector. Não altere a menos que instruído pelo suporte Jitterbit. |
jitterbit.connectorcall.timeout |
300 |
Tempo limite de chamada do conector (segundos) para determinados conectores. Não altere a menos que instruído pelo suporte Jitterbit. |
jitterbit.connector.disable.file.watcher |
false |
Se true, desativa o file watcher do conector. Não altere a menos que instruído pelo suporte Jitterbit. |
jitterbit.connector.max.recent.connector.lookup |
15 |
Número máximo de checksums de conector md5 a manter. (Se o checksum de um novo conector corresponder a um existente, o download é ignorado.) |
jitterbit.connector.max.temp.file.write.attempts |
30 |
Número máximo de tentativas para mover um arquivo temporário do conector. |
[DbDrivers]
Esta seção especifica os caracteres especiais padrão usados para delimitar nomes em alguns drivers utilizados pelo conector Database. Os delimitadores suportados incluem: / . \* = ? | ( ) [ ] { }.
As chaves e valores são envoltos em aspas simples, e caracteres especiais são escapados com \.
| Chave | Padrão |
|---|---|
DataDirect 32-BIT SequeLink 5.4 Quote Begin |
\" |
DataDirect 32-BIT SequeLink 5.4 Quote End |
\" |
Excel Quote Begin |
[ |
Excel Quote End |
] |
IBM DB2 (AS400) Quote Begin |
\" |
IBM DB2 (AS400) Quote End |
\" |
Microsoft Access Driver (*.mdb) Quote End |
] |
Microsoft Excel Driver (*.xls) Quote Begin |
[ |
Microsoft Excel Driver (*.xls) Quote End |
] |
Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote Begin |
[ |
Microsoft Excel Driver (*.xls, *.xlsx, *.xlsm, *.xlsb) Quote End |
] |
Microsoft ODBC for Oracle Quote Begin |
\" |
Microsoft ODBC for Oracle Quote End |
\" |
Microsoft Quote Begin |
[ |
MySQL ODBC 3.51 Driver Quote Begin |
` |
MySQL ODBC 3.51 Driver Quote End |
` |
MySQL ODBC 5.1 Driver Quote Begin |
` |
MySQL ODBC 5.1 Driver Quote End |
` |
MySQL Quote Begin |
` |
MySQL Quote End |
` |
Oracle ODBC Driver Quote Begin |
\" |
Oracle ODBC Driver Quote End |
\" |
Oracle Quote Begin |
\" |
Oracle Quote End |
\" |
Oracle in OraClient10g_home2 Quote Begin |
\" |
Oracle in OraClient10g_home2 Quote End |
\" |
Oracle in XE Quote Begin |
\" |
Oracle in XE Quote End |
\" |
PostgreSQL ANSI Quote Begin |
\" |
PostgreSQL ANSI Quote End |
\" |
PostgreSQL Quote Begin |
\" |
PostgreSQL Quote End |
\" |
PostgreSQL Unicode Quote Begin |
\" |
PostgreSQL Unicode Quote End |
\" |
PostgreSQL-psql Quote Begin |
\" |
PostgreSQL-psql Quote End |
\" |
SQL Server Quote Begin |
[ |
SQL Server Quote End |
] |
[DbInfo]
| Key | Default | Descrição |
|---|---|---|
User |
jitterbit |
Nome de usuário do banco de dados PostgreSQL local. |
DisableOdataCount |
false |
Desativa as configurações $count e $inlinecount em consultas OData recebidas. Define como true se a funcionalidade de contagem de banco de dados causar problemas de desempenho. |
Password |
None | Senha do banco de dados PostgreSQL local. Cada instalação gera uma nova senha, mesmo no mesmo host. A senha na imagem do Docker Hub muda entre versões e é a mesma para todos os contêineres baseados em uma imagem. |
Driver |
'PostgreSQL Unicode(x64)' |
Padrão do Windows. |
'PostgreSQL-jitterbit' |
Padrão do Linux. | |
SystemDbName |
'postgres' |
Nome do banco de dados do sistema PostgreSQL. |
Server |
127.0.0.1 |
Nome de host ou endereço IP do servidor PostgreSQL. |
Port |
6432 |
Porta padrão do servidor PostgreSQL. (6543 em agentes privados versão 10.60 ou anterior.) |
UseInternalPooling |
true |
Se true, ativa o pool de conexão de banco de dados interno para otimizar o desempenho do agente. (Isso agrupa apenas o banco de dados interno do agente; para agrupamento de conexões de banco de dados de origem e destino, consulte [SourceTargetPooling].)
|
[Debug]
| Key | Default | Descrição |
|---|---|---|
WebServiceDebugFile |
'' |
Caminho absoluto para o arquivo de debug dos serviços Web de backend. Se uma string vazia, o logging fica desativado. O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. |
[ErrorHandling]
Esta seção configura como tratar possíveis situações de erro no backend. Os valores possíveis são:
Ok: A situação é normal; continue normalmente.Warning: Registre um aviso e continue.Error: A situação é fatal.
| Key | Default | Description |
|---|---|---|
NoRowsAffectedOnDbUpdates |
Ok |
Uma instrução de atualização em um destino de banco de dados que não afeta nenhuma linha é Ok conforme a definição acima. |
NoTargetDataGenerated |
Ok |
Nenhum dado de destino foi gerado é Ok conforme a definição acima. |
NoWebServiceRequestData |
Warning |
Nenhum dado disponível para gerar uma solicitação de serviço Web válida gera um Warning conforme a definição acima. |
EmptyDatabaseSource |
Warning |
Uma fonte de banco de dados simples vazia gera um Warning conforme a definição acima. |
[FileCleanup]
| Key | Default | Description |
|---|---|---|
AutoStart |
true |
Inicia as rotinas de limpeza de arquivos. |
SleepTimeInSeconds |
5 |
Tempo de espera da limpeza de arquivos (segundos). |
FrequencyInHours |
24.0 |
Intervalo de limpeza de arquivos (horas). |
[HttpConnectionPool]
Esta seção é usada com configurações de proxy para chamar recursos externos.
| Key | Default | Description |
|---|---|---|
MaxConnections |
50 |
Número máximo de conexões totais a manter no pool. Se 0 ou menos, use o valor padrão da biblioteca Apache HttpClient. |
MaxConnectionsPerRoute |
5 |
Número máximo de conexões por rota. Se 0 ou menos, use o valor padrão da biblioteca Apache HttpClient. |
TimeoutInSeconds |
60 |
Tempo limite de conexão do pool (segundos). Se 0 ou menos, use o valor padrão da biblioteca Apache HttpClient. |
HttpSocketTimeoutInSeconds |
180 |
Tempo limite do socket do cliente (segundos), o tempo que o socket do cliente aguarda uma resposta depois de estabelecer a conexão e enviar uma solicitação. Se 0 ou menos, use o valor padrão da biblioteca Apache HttpClient. |
HttpConnectionTimeoutInSeconds |
180 |
Tempo limite (segundos) para aguardar a conexão com o host remoto. |
[HttpConnectionPoolLocal]
Esta seção é usada com recursos locais (serviços SOAP, API).
| Key | Default | Description |
|---|---|---|
MaxConnections |
50 |
Número máximo de conexões totais a manter no pool. Se 0 ou menos, use o valor padrão da biblioteca Apache HttpClient. |
MaxConnectionsPerRoute |
50 |
Número máximo de conexões por rota. Se 0 ou menos, use o valor padrão da biblioteca Apache HttpClient. |
TimeoutInSeconds |
60 |
Tempo limite de conexão do pool (segundos). Se 0 ou menos, use o valor padrão da biblioteca Apache HttpClient. |
HttpSocketTimeoutInSeconds |
180 |
Tempo limite do socket do cliente (segundos) (tempo que o socket do cliente aguarda uma resposta depois de estabelecer a conexão e enviar uma solicitação). Se 0 ou menos, use o valor padrão da biblioteca Apache HttpClient. |
HttpConnectionTimeoutInSeconds |
180 |
Tempo limite (segundos) para aguardar a conexão com o host remoto. |
Dica
Se você definir MaxConnections e MaxConnectionsPerRoute como 100, faça estas alterações adicionais:
-
Edite o arquivo
jitterbit-agent-config.propertiese defina:max.concurrent.requests=100 -
Edite o arquivo
httpd.confe defina:ThreadsPerChild 101
[HttpEndPoints]
| Chave | Padrão | Descrição |
|---|---|---|
EnableErrorLogging |
true |
Registra erros de chamada de endpoint HTTP hospedado no log de operação. Ignorado quando EnableLogging é true. |
EnableLogging |
true |
Registra todas as chamadas de endpoint HTTP hospedado no log de atividade. |
[JavaBackend]
| Chave | Padrão | Descrição |
|---|---|---|
DebugLogLevel |
(Nenhum) | Nível de [log] de depuração do Tomcat (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Os logs do servidor Tomcat são gravados em JITTERBIT_HOME/tomcat/logs. Consulte CleanupRules.xml para períodos de limpeza de arquivos de log. |
[JavaUiBackend]
| Chave | Padrão | Descrição |
|---|---|---|
LogLevel |
OFF |
Nível de [log] da interface do usuário Java (Tomcat) (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Os logs do servidor Tomcat são gravados em JITTERBIT_HOME/tomcat/logs. Consulte CleanupRules.xml para períodos de limpeza de arquivos de log. |
[JDBCEngine]
| Chave | Padrão | Descrição |
|---|---|---|
SessionTimeout |
60 |
Tempo limite de sessão JDBC aberta (minutos). |
ClientSessionTimeout |
180 |
Tempo máximo de operação JDBC (minutos). |
LogLevel |
INFO |
Nível de [log] do mecanismo JDBC (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Os logs do servidor Tomcat são gravados em JITTERBIT_HOME/tomcat/logs. Consulte CleanupRules.xml para períodos de limpeza de arquivos de log. |
[JdbcSecurity]
Esta seção foi adicionada na versão 12.10 do agente. Restringe cadeias de conexão JDBC e conexões para o conector de banco de dados, por segurança.
| Chave | Padrão | Descrição |
|---|---|---|
block.localhost.connections |
true |
Bloqueia uma conexão de banco de dados com localhost ou 127.0.0.1 quando true. Defina como false para permitir uma conexão de banco de dados com um banco de dados executado no mesmo host que o agente. |
mysql.blocked.params |
Ver abaixo | Parâmetros de cadeia de conexão JDBC do MySQL que são sempre rejeitados. |
mysql.forced.false.params |
Ver abaixo | Parâmetros de cadeia de conexão JDBC do MySQL que são rejeitados se definidos como true na cadeia de conexão. |
postgresql.blocked.params |
Ver abaixo | Parâmetros de cadeia de conexão JDBC do PostgreSQL que são sempre rejeitados. |
oracle.blocked.params |
Ver abaixo | Parâmetros de cadeia de conexão JDBC do Oracle que são sempre rejeitados. |
sqlserver.blocked.params |
Ver abaixo | Parâmetros de cadeia de conexão JDBC do SQL Server que são sempre rejeitados. |
O exemplo a seguir mostra a seção completa com seus valores padrão. Para permitir uma conexão ou parâmetro específico mantendo o restante restrito, copie-o e remova esse parâmetro do valor da chave relevante:
[JdbcSecurity]
block.localhost.connections=true
mysql.blocked.params=queryinterceptors,statementinterceptors,propertiestransform,socketfactory,socksproxyhost
mysql.forced.false.params=allowLoadLocalInfile,allowLocalInfile,allowUrlInLocalInfile,autoDeserialize,allowMultiQueries
postgresql.blocked.params=socketfactory,socketfactoryarg,sslfactory,sslfactoryarg,sslhostnameverifier,sslpasswordcallback,authenticationpluginclassname,loggerfile,loggerlevel
oracle.blocked.params=oracle.net.tns_admin,oracle.net.wallet_location
sqlserver.blocked.params=socketfactoryclass
Para permitir todos os parâmetros de uma chave, defina-a como um valor vazio (por exemplo, mysql.blocked.params=).
Aviso
Comentar uma das cinco chaves *.blocked.params ou *.forced.false.params (com um # no início) não restaura sua restrição padrão. Tem o mesmo efeito que definir a chave como um valor vazio: cada parâmetro dessa chave fica permitido. Para restaurar a restrição padrão após adicionar esta seção, delete a linha da chave completamente ou comente a linha [JdbcSecurity] em si, o que restaura cada chave na seção ao seu padrão.
[JsonParser]
Esta seção foi adicionada na versão 12.5 do agente.
| Chave | Padrão | Descrição |
|---|---|---|
MaxStringLength |
20000000 |
Número máximo de caracteres permitidos em um único valor de string JSON. Operações que processam strings JSON que excedem este limite falham com um erro StreamConstraintsException. Aumente este valor se precisar processar payloads JSON maiores (por exemplo, defina como 50000000 para um limite de 50 MB). |
[LDAP]
Use esta seção para adicionar suporte a UTF-8 para Microsoft Windows e Active Directory com agentes privados Windows.
| Chave | Padrão | Descrição |
|---|---|---|
CharacterEncoding |
ISO-8859-1 |
Codificação de caracteres LDAP. |
Dica
Se usar a função LDAPReplace() para substituir um valor em um Active Directory conforme mostrado abaixo, você pode perceber que o texto é convertido para um resultado diferente da entrada, como François sendo substituído por FrançOis:
LdapReplace("givenName", "François");
Em casos assim, adicione esta seção e reinicie o agente.
Para mais informações, consulte Funções LDAP do Studio ou Funções LDAP do Design Studio.
[Masking]
Esta seção foi adicionada na versão 11.59 / 12.3 do agente. Estas configurações podem ser usadas para mascarar cabeçalhos de solicitação personalizados em atividades HTTP do Studio e fontes HTTP do Design Studio e destinos. Quando um cabeçalho de solicitação é mascarado, os valores mascarados aparecem como ***REDACTED*** nos logs de tempo de execução.
| Chave | Padrão | Descrição |
|---|---|---|
HttpRequestHeaders |
true |
Se false, os cabeçalhos de solicitação fornecidos em RequestHeaders não serão mascarados. |
RequestHeaders |
Lista separada por vírgula de cabeçalhos de solicitação personalizados a serem mascarados (por exemplo, security_key,test_header,test_header2). |
Observe que os seguintes cabeçalhos de solicitação já são mascarados por padrão nos logs de tempo de execução e não exigem o uso dessas configurações:
| Categoria | Nome do cabeçalho |
|---|---|
| Autenticação e tokens | authorizationproxy-authorizationx-api-keyx-auth-tokenx-access-tokenx-refresh-tokenx-session-tokenx-id-tokenx-client-secret |
| Cookies e CSRF | cookiex-csrf-tokenx-xsrf-token |
| Informações Pessoais (GDPR / CCPA) | x-user-idx-user-emailx-user-namex-user-phonex-user-addressx-customer-idx-employee-idx-national-idx-date-of-birthx-ip-addressx-forwarded-forx-real-ipx-originating-ip |
| Pagamento (PCI-DSS) | x-card-numberx-card-cvvx-card-expiryx-bank-accountx-payment-token |
| Saúde (HIPAA) | x-patient-idx-medical-recordx-health-plan-idx-diagnosis-code |
| Roteamento e rastreamento internos | x-internal-ipx-backend-serverx-cluster-nodex-request-idx-correlation-id |
[MetricLogging]
Importante
Esta seção está descontinuada desde a versão 11.41 do agente privado e será removida em uma versão posterior. As chaves foram movidas para a seção [AgentMetrics], com algumas chaves sendo renomeadas. Consulte essa seção para obter detalhes.
| Chave | Padrão | Descrição |
|---|---|---|
EnableAgentMetricLogging |
false |
Se true, o log de métricas do agente fica habilitado. |
EnableAgentMetricAsyncLogging |
true |
Se true, o log é executado de forma assíncrona. Não altere a menos que instruído pelo suporte Jitterbit. |
EnableAgentSyncMetricLogging |
Se true, habilita o log de métricas de sincronização. |
|
SchedulerMetricThreads |
100 |
Tamanho do pool de threads do agendador de métricas. |
ProcessEngineMetricThreads |
Valor de MaxNumberOfWorkerThreads em [ProcessEngine] |
Tamanho do pool de threads do mecanismo de processo de métricas. |
OperationEngineMetricThreads |
(Nenhum) | Se RunOperationsInSeparateProcess=true, usa essa quantidade de threads do pool de threads. |
[OperationEngine]
| Chave | Padrão | Descrição |
|---|---|---|
Debug |
false |
Habilita o modo de debug. Os valores de Debug e WriteLog precisam estar definidos como 1 para que os logs sejam gerados. |
AlwaysRunSuccessOperation |
false |
Sempre executa as operações com sucesso, mesmo que não haja dados. |
TemporaryStorageRootDirectory |
(Nenhum) | Caminho absoluto para o diretório raiz de armazenamento temporário. Se não especificado, usa TemporaryStorage anexado ao valor de TempDir (C:\Windows\Temp\jitterbit\TemporaryStorage no Windows, /tmp/jitterbit/TemporaryStorage no Linux). O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. |
MaxNumberOfOperationThreads |
(Nenhum) | Número máximo de threads de operação. Se não especificado, o número de threads de operação é ilimitado. |
MaxOperationStackDepth |
50 |
Número máximo de chamadas de operação síncrona aninhadas. Se 0 ou um número negativo, o máximo é ilimitado. |
MaxAsyncOperationChainLength |
50 |
Número máximo de operações assíncronas permitidas em uma única cadeia (para evitar loops infinitos de operação). Se 0 ou um número negativo, o máximo é ilimitado. |
MaxAsyncOperationChainLengthOverrideAllowed |
true |
Substitui o comprimento máximo da cadeia de operações assíncrona definindo a variável Jitterbit jitterbit.operation.max_async_chain_length. |
MaxSynchronousRunOperationCallsInLoop |
50 |
(Adicionado na versão 12.11.) Número máximo de chamadas síncronas de RunOperation permitidas dentro de um único loop While. Se 0 ou um número negativo, o máximo é ilimitado. |
MaxSynchronousRunOperationCallsInLoopOverrideAllowed |
true |
(Adicionado na versão 12.11.) Substitui o número máximo de chamadas síncronas de RunOperation permitidas em um loop definindo a variável Jitterbit jitterbit.operation.max_sync_runop_calls_in_loop. Defina como false para bloquear o limite no nível de configuração do agente. |
MaxSynchronousRunOperationCallsInLoopCustomError |
(Nenhum) | (Adicionado na versão 12.11.) Texto de erro personalizado a ser exibido em vez da mensagem gerada padrão quando o limite é atingido. Coloque a mensagem entre aspas simples; caso contrário, ela é truncada no primeiro espaço em branco. O nome da operação invocada (voltando para seu GUID se não for possível resolver o nome) é anexado a essa mensagem para identificar qual operação filho atingiu o limite. |
AlwaysDeleteTempDir |
false |
Exclui arquivos temporários, mesmo em caso de erro. Cuidado Quando o log de debug de operação está habilitado, definir esse valor como |
WriteLog |
0 |
Habilita (1) ou desabilita (0) mensagens de processo adicionais para operações de API e agendadas serem gravadas no arquivo de log. |
[PredefinedGlobalVariables]
Qualquer variável do Jitterbit pode ser definida nesta seção para ser aplicada em todo o grupo de agentes por padrão. Para definir uma variável do Jitterbit no nível de operação, consulte Definir variáveis do Jitterbit em scripts ou transformações.
A tabela abaixo lista exemplos de variáveis do Jitterbit que podem ser definidas nesta seção. Esta lista não é exaustiva; consulte a documentação de variáveis do Jitterbit de cada variável individual para obter a descrição de cada uma.
| Chave | Padrão | Descrição |
|---|---|---|
jitterbit.http.enable_cookies |
false |
Ativa cookies para conexões HTTP. |
jitterbit.scripting.db.auto_commit |
true |
Confirma automaticamente scripts de banco de dados. Se false, usa transações de banco de dados. |
jitterbit.scripting.db.max_rows |
10000 |
Número máximo de linhas de banco de dados afetadas. Aplica-se a DBExecute, DBLookup e DBLookupAll funções de banco de dados do Studio ou funções de banco de dados do Design Studio. |
jitterbit.scripting.ldap.include_dn_in_results |
false |
Se true, inclui o nome distinguido (DN) no Active Directory. |
jitterbit.scripting.ldap.max_search_results |
1 |
Número máximo de resultados de busca LDAP retornados. |
jitterbit.scripting.ldap.return_null_if_no_results |
false |
Se true, consultas LDAP sem registros correspondentes retornam um único valor NULL. |
jitterbit.scripting.ldap.scope |
1 |
Ativa (1) ou desativa (0) LDAP. |
jitterbit.scripting.ldap.use_paged_search |
false |
Ativa busca LDAP paginada em scripts. Se true, o Jitterbit recupera dados em páginas e evita exceder limites do Active Directory. |
jitterbit.scripting.nesting.max |
10 |
Número máximo de scripts aninhados. |
jitterbit.scripting.while.max_iterations |
50000 |
Limite de iteração do script Jitterbit. |
jitterbit.source.db.preserve_char_whitespace |
false |
Preserva espaços em branco de caracteres iniciais e finais do banco de dados de origem. |
jitterbit.source.ftp.transfer_timeout |
3600 |
Tempo limite de transferência FTP de origem (segundos). |
jitterbit.source.text.csv_nullable |
false |
Permite valores nulos em arquivos de texto CSV. |
jitterbit.target.db.include_null_in_sql_statement |
false |
Inclui nulo nas instruções SQL do banco de dados de destino. |
jitterbit.target.ftp.transfer_timeout |
3600 |
Tempo limite de transferência FTP de destino (segundos). |
jitterbit.target.http.remove_trailing_linebreaks |
true |
Remove quebras de linha à direita antes de postar dados de destino. |
jitterbit.target.xml.num_for_bool |
false |
Se true, representa valores booleanos XML como 0 e 1. Se false, usa false e true. |
[PredefinedServerGlobalDataElement]
| Chave | Padrão | Descrição |
|---|---|---|
| (Definido pelo usuário) | (Definido pelo usuário) | Variáveis globais predefinidas personalizadas que são inicializadas para qualquer operação iniciada no agente. |
[ProcessEngine]
| Chave | Padrão | Descrição |
|---|---|---|
MaxNumberOfWorkerThreads |
auto |
Número de threads de trabalho (1 a 200). Quando auto, o número é o dobro do número de núcleos do processador. |
RunOperationsInSeparateProcess |
true |
Se true, o tempo de execução da operação é ilimitado. Use MaxOperationRuntimeSeconds para definir um limite de tempo de execução. |
MaxOperationRuntimeSeconds |
(Nenhum) | Tempo máximo de execução da operação (segundos). Ignorado se RunOperationsInSeparateProcess for false. |
MaxOperationRuntimeMessage |
(Nenhum) | Mensagem exibida quando o limite de tempo de execução é atingido. Ignorado se RunOperationsInSeparateProcess for false. |
EnableDebugDump |
false |
Se não especificado, DebugDumpDir usará como padrão a configuração TempDir em [Settings]. |
DebugDumpDir |
(Nenhum) | Caminho absoluto para o diretório de despejo de depuração. Se não definido, o valor de TempDir é usado. Ignorado a menos que EnableDebugDump seja true. O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. |
[ResultFiles]
| Chave | Padrão | Descrição |
|---|---|---|
DisableSuccess |
false |
Criar arquivos de sucesso. |
DisableFailure |
false |
Criar arquivos de falha. |
[Scheduler]
| Chave | Padrão | Descrição |
|---|---|---|
AutoStart |
1 |
Ativar (1) ou desativar (0) o início automático do agendador. |
SleepTimeInSeconds |
5 |
Tempo de espera (segundos). |
WriteLog |
0 |
Ativar (1) ou desativar (0) o registro de depuração do agendador. O arquivo de log está em scheduler_debug.log no diretório especificado pelo valor de TempDir. |
[Settings]
| Chave | Padrão | Descrição |
|---|---|---|
TempDir |
(Nenhum) | Caminho absoluto para um diretório temporário. Se em branco, os arquivos temporários usam o diretório temporário do SO (%temp%\jitterbit no Windows, /tmp/jitterbit no Linux). O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. |
CurlDebugDir |
(Nenhum) | Caminho absoluto para o arquivo de log do curl para solicitações FTP, SFTP, HTTP e HTTPS. Um arquivo criado por solicitação. Os nomes dos arquivos de log são GUID com extensão .txt. O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. |
CurlDefaultSSLVersionMax |
true |
Se true, use a opção --tls-max (aplica-se ao curl 7.54.0 e superior). |
EnableLocalFileLocation |
false |
Permitir criação de arquivo local. Necessário para o conector Local Storage, arquivos de acionamento ou pastas de sucesso/erro configuradas em outros conectores. |
JavaScriptMaxIterations |
50000 |
Número máximo de iterações de loop permitidas por script. |
RecoverableStatusCode |
500, 502, 503, 504 |
Quando definido e a opção Retry é selecionada em uma conexão HTTP, a atividade se recupera dos códigos de erro listados e tenta novamente a atividade. |
EnableAPITimeout |
false |
Se true, operações disparadas por APIs do API Manager usarão configurações de tempo limite de operação. |
TargetHttpRemoveTrailingLinebreaks |
false |
Se true, remover CR/LF no final das linhas nas transformações posteriores do conector HTTP. |
AllowUnsafeLegacyRenegotiation |
false |
Se true, permitir renegociação TLS legada não segura durante o handshake de conexão com o servidor. Necessário para evitar o erro error:0A000152:SSL routines::unsafe legacy renegotiation disabled. Compatível com agentes versão 11.39 e posterior. |
RollbackRetryEnabled |
true |
Se true, o agente tenta novamente uma inserção de banco de dados interno mesmo após uma falha de reversão, correspondendo ao comportamento padrão usado antes dessa configuração ser introduzida na versão 11.49 do agente. Se false, a inserção não será tentada novamente após uma falha de reversão, evitando reinserção de dados da transação quebrada. Não altere a menos que instruído pelo suporte Jitterbit. |
[Settings/XMLSchemas]
Essas configurações definem os locais dos esquemas XML disponíveis.
| Chave | Padrão |
|---|---|
Schema_2001 |
JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/XMLSchema_2001.xsd |
Schema_1999 |
JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/XMLSchema_1999.xsd |
SoapEncoding |
JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/SOAP_Encoding.xsd |
WSDL |
JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/WSDL.xsd |
SoapEncoding_v11 |
JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/SOAP_Encoding_v11.xsd |
SoapEncoding_v12 |
JITTERBIT_HOME/DataInterchange/xml_dtd/Schemas/SOAP_Encoding_v12.xsd |
[SMTPClient]
| Chave | Padrão | Descrição |
|---|---|---|
DefaultSMTPServers |
(Nenhum) | Lista separada por vírgula de servidores SMTP para usar quando uma mensagem de e-mail deve ser enviada e nenhum servidor SMTP é especificado pelo usuário. |
DefaultFromEmail |
(Nenhum) | Endereço de e-mail a usar no campo De se nenhum for especificado pelo usuário. |
DefaultAccount |
(Nenhum) | Nome de login para servidores SMTP que exigem autenticação. |
DefaultAccountPassword |
(Nenhum) | Senha para servidores SMTP que exigem autenticação. |
UseSSL |
(Nenhum) | Se true, o servidor SMTP exige SSL/TLS. |
Nota
Endpoints criados usando a função SendSystemEmail com DefaultSMTPServers estão incluídos no relatório de uso de endpoints e contam para sua licença.
[SourceTargetPooling]
Essas configurações definem o pool de conexões para conexões de banco de dados de origem e destino, usadas por uma Conexão de banco de dados no Studio ou uma origem e destino de banco de dados no Design Studio. O pool de conexões reutiliza conexões JDBC em operações em vez de abrir e fechar uma nova conexão a cada vez, reduzindo a sobrecarga de conexão e o risco de timeout sob carga simultânea. Isso é separado do pool de conexões do banco de dados interno do agente (consulte [DbInfo] UseInternalPooling). Disponível com versão do agente 12.11 e posterior.
| Chave | Padrão | Descrição |
|---|---|---|
jdbc.hikari.enabled |
false |
Se true, ativa o pool de conexões. Se false, as conexões usam o mesmo comportamento das versões do agente anteriores a 12.11: abrindo e fechando uma nova conexão para cada operação. |
jdbc.hikari.maximumPoolSize |
5 |
Conexões máximas por pool. |
jdbc.hikari.minimumIdle |
0 |
Número mínimo de conexões ociosas que o HikariCP tenta manter no pool. Com o padrão de 0, as conexões são criadas sob demanda em vez de serem pré-aquecidas. |
jdbc.hikari.connectionTimeout |
30000 |
Tempo máximo (milissegundos) para aguardar uma conexão do pool antes de falhar. Isso é separado da configuração Tempo limite (s) em uma Conexão de banco de dados no Studio ou uma origem e destino de banco de dados no Design Studio, que continua limitando a tentativa de conexão subjacente sempre que o pool cria uma nova conexão física. |
jdbc.hikari.idleTimeout |
300000 |
Tempo máximo (milissegundos) que uma conexão pode ficar ociosa no pool antes de ser desativada. |
jdbc.hikari.maxLifetime |
1800000 |
Tempo de vida máximo (milissegundos) de uma conexão no pool antes de ser desativada, mesmo se em uso. |
jdbc.hikari.connectionTestQuery |
(Nenhum) | Consulta usada para validar uma conexão antes de ser retornada do pool. Deixada em branco por padrão, o que usa o método de validação do driver JDBC em vez de uma consulta fixa. Sobrescrever isso aplica a mesma consulta a todos os bancos de dados que usam este pool. |
jdbc.hikari.validationTimeout |
5000 |
Tempo máximo (milissegundos) para aguardar a conclusão de jdbc.hikari.connectionTestQuery. |
jdbc.hikari.leakDetectionThreshold |
0 |
Se definido acima de 0, milissegundos que uma conexão pode ser retirada antes que o HikariCP registre um possível aviso de vazamento de conexão com um rastreamento de pilha. 0 desativa a detecção de vazamento. |
jdbc.hikari.poolEvictionThresholdMinutes |
60 |
Minutos que um pool pode permanecer ocioso com zero conexões ativas antes de ser elegível para evicção. 0 desativa a evicção. |
jdbc.hikari.poolNamePrefix |
JitterbitSourceTarget |
Prefixo usado para nomear pools em logs e monitoramento JMX. |
jdbc.hikari.poolStatsEnabled |
true |
Se true, registra estatísticas por pool (conexões ativas, ociosas, total e aguardando) no cronograma de manutenção periódica definido por jdbc.hikari.statsInitialDelayMinutes e jdbc.hikari.statsIntervalMinutes. Essa configuração controla apenas as linhas por pool; uma linha agregada de estatísticas de pool de conexão separada registra no mesmo cronograma independentemente desta configuração. |
jdbc.hikari.statsInitialDelayMinutes |
5 |
Minutos após a inicialização do agente antes da primeira execução de manutenção periódica (registro de estatísticas e evicção de pools ociosos). |
jdbc.hikari.statsIntervalMinutes |
5 |
Minutos entre execuções de manutenção periódica após a primeira. Deve ser um número positivo; 0 ou um número negativo volta ao padrão em vez de desativar o cronograma. |
jdbc.hikari.connStatsSampleRate |
1 |
Registra 1 em cada \(N\) solicitações de conexão bem-sucedidas por entidade de banco de dados, para reduzir o volume de log. 1 registra cada solicitação. Solicitações de conexão com falha são sempre registradas, independentemente dessa configuração. |
[SSH]
| Chave | Padrão | Descrição |
|---|---|---|
PublicKeyFile |
(Nenhuma) | Caminho absoluto para sua chave pública. O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. Defina as permissões do arquivo como somente leitura para o usuário Jitterbit. |
PrivateKeyFile |
(Nenhuma) | Caminho absoluto para sua chave privada. O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. Defina as permissões do arquivo como somente leitura para o usuário Jitterbit. |
PrivateKeyPassphrase |
(Nenhuma) | Frase de senha da chave privada. Defina as permissões do arquivo como somente leitura para o usuário Jitterbit. |
| Conjuntos adicionais | (Nenhuma) | Configurado pelo usuário. |
Conjuntos adicionais
Para conjuntos adicionais, adicione um sufixo (por exemplo XXX) a essas chaves (para criar PublicKeyFileXXX, PrivateKeyFileXXX, PrivateKeyPassphraseXXX) e depois as referencie em variáveis de script do Jitterbit com $jitterbit.source.sftp.ssh_key_id="XXX" ou $jitterbit.target.sftp.ssh_key_id="XXX".
[SSL]
| Chave | Padrão | Descrição |
|---|---|---|
CertificateFile |
(Nenhuma) | Caminho absoluto para seu arquivo de certificado SSL do cliente. O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. Apenas certificados e chaves no formato PEM são suportados. Defina as permissões do arquivo como somente leitura para o usuário Jitterbit. |
PrivateKeyFile |
(Nenhuma) | Caminho absoluto para sua chave privada. O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. Apenas certificados e chaves no formato PEM são suportados. Defina as permissões do arquivo como somente leitura para o usuário Jitterbit. |
PrivateKeyPassphrase |
(Nenhuma) | Frase de senha da chave privada. O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. Apenas certificados e chaves no formato PEM são suportados. Defina as permissões do arquivo como somente leitura para o usuário Jitterbit. |
| Conjuntos adicionais | (Nenhuma) | Configurado pelo usuário. |
Conjuntos adicionais
Para conjuntos adicionais, adicione um sufixo (por exemplo YYY) a essas chaves (para criar CertificateFileYYY, PrivateKeyFileYYY, PrivateKeyPassphraseYYY) e depois as referencie em variáveis de script do Jitterbit com $jitterbit.target.http.ssl_cert_id = "YYY";, $jitterbit.source.http.ssl_cert_id = "YYY"; ou $jitterbit.web_service_call.ssl_cert_id = "YYY";.
[TraceLogging]
| Chave | Padrão | Descrição |
|---|---|---|
tracelog.shipper.enabled |
false |
Se true, ativa o log de rastreamento do mecanismo de operação no agente. |
[TransformationEngine]
| Chave | Padrão | Descrição |
|---|---|---|
WriteLog |
false |
Log de depuração detalhado de transformação. Se true, Debug em [OperationEngine] é definido como true. |
WriteLogDir |
(Nenhuma) | Caminho absoluto para o diretório de log. Se não especificado, os logs são gravados em JITTERBIT_HOME/DataInterchange/Temp/Debug. Ignorado a menos que WriteLog seja 1. O caminho deve usar barras invertidas, mesmo no Windows. O diretório deve existir e ter permissões de leitura-escrita para o agente. |
ValidateXML |
true |
Validação de XML. |
LdapEnableAutoUpdateMode |
false |
Ativa o modo de atualização automática de LDAP. |
TimingOn |
false |
Ativa (1) ou desativa (0) globalmente a criação de perfil de arquivo. Os arquivos são gravados em JITTERBIT_HOME/DataInterchange/Temp/LOG. |
AutoStreaming |
true |
Streaming automático de transformação. |
UseOldRuleForLoopOneOfXmlNode |
false |
(Use para compatibilidade com versões anteriores.) |
AutoXsiNil |
false |
Define o atributo xsi:nil="true" para elementos obrigatórios e não mapeados em transformações. |
DefaultEntityResolution |
true |
Ativa a análise de tipos de IDoc. |
[VerboseLogging]
Esta seção é usada para a geração de dados de entrada e saída de componentes quando o log de depuração de operação está ativado em uma operação Studio individual.
Os dados de entrada e saída de componentes são registrados na nuvem do Harmony, a menos que verbose.logging.enable esteja definido como false. A configuração de log na nuvem não afeta este tipo de logging.
Isso substitui a geração de dados de entrada e saída de componentes quando Enable Debug Logging Until é configurado em uma operação Studio individual, mas não impede que arquivos de log de depuração de operação sejam gerados.
| Key | Default | Description |
|---|---|---|
verbose.logging.enable |
true |
Quando o log de depuração de operação está ativado em uma operação Studio individual, escreve dados de entrada e saída de componentes no log da operação Studio. |
verbose.logging.commpress.folder.path |
(None) | Comentado. Não altere a menos que instruído pelo suporte Jitterbit. commpress (dois 'm') é um erro de digitação conhecido desta propriedade. |
verbose.logging.log.folder.path |
(None) | Comentado. Não altere a menos que instruído pelo suporte Jitterbit. |
verbose.logging.log.file.extension |
.verbose |
Usado para log de depuração de operação. Não altere a menos que instruído pelo suporte Jitterbit. |
verbose.logging.use.dynamic.host.for.collector.url |
true |
Usado para log de depuração de operação. Não altere a menos que instruído pelo suporte Jitterbit. |
verbose.logging.collector.url |
(None) | URL do serviço de coletor de logs. |
[XsltEngine]
Esta seção foi adicionada na versão 12.11 do agente. Ela restringe declarações DOCTYPE e resolução de entidades externas ao processar a função RunXSLT, por motivos de segurança.
| Key | Default | Description |
|---|---|---|
BlockExternalEntities |
true |
Bloqueia declarações de entidades gerais externas e de parâmetros (por exemplo, <!ENTITY name SYSTEM "...">) quando true. |
BlockDtdDeclarations |
true |
Bloqueia entrada XML contendo uma declaração DOCTYPE quando true. |
BlockExternalDtd |
true |
Bloqueia o carregamento de arquivos DTD externos quando true. |
BlockUriSchemes |
true |
Bloqueia document('file://...') e outras chamadas de esquema URI externo em folhas de estilo XSLT quando true. |
Para permitir este processamento, defina a chave correspondente como false.