Saltar al contenido

Archivo de configuración del agente privado de Jitterbit jitterbit.conf

Introducción

Esta página describe el archivo de configuración principal para agentes privados, jitterbit.conf. Se encuentra en el directorio de instalación (JITTERBIT_HOME), de forma predeterminada C:\Program Files\Jitterbit Agent\ en Microsoft Windows, /opt/jitterbit/ en Linux y Docker.

El archivo usa el formato INI file, en el que los nombres de las secciones están entre corchetes, y cada sección es una lista de pares clave-valor. Las secciones pueden estar en cualquier orden dentro del archivo. (Esta página ordena las secciones alfabéticamente, pero no lo están así en el archivo predeterminado). Si hay secciones o claves que no se encuentran en tu archivo, debes agregarlas; algunas no se proporcionan en el archivo predeterminado. Para las claves que no están presentes o están comentadas (con un # inicial), se aplica el valor predeterminado. Los valores booleanos se pueden proporcionar como 0/1 o false/true. Las rutas usan barras diagonales hacia adelante, incluso cuando se especifican ubicaciones de Windows.

Importante

Los cambios realizados en el archivo no se aplican hasta que se reinicia el agente, y no se sobrescriben al actualizar.

[AgentCapability]

Estos ajustes se aplican a las características de observabilidad del agente privado nativo y de terceros.

Las métricas de uso de memoria se recopilan solo en agentes de Windows. En agentes de Linux, el uso de memoria no se utiliza en el cálculo de capacidad, y la configuración de memoria en esta sección no tiene efecto.

Apache sirve solo solicitudes de API, por lo que la configuración de subprocesos de Apache en esta sección es relevante solo en un agente que maneja API.

Cuando las métricas de uso de CPU o memoria están habilitadas, anulan los demás datos de entrada de capacidad: si alguna de ellas supera su umbral, el agente reporta como incapaz sin importar la disponibilidad de subprocesos de Apache o subprocesos de trabajo del motor de procesos.

Importante

No cambies ningún valor en esta sección a menos que el soporte de Jitterbit te lo indique.

Clave Predeterminado Descripción
ApacheThreadBuffer 10 Buffer de límite de subprocesos de Apache.
ApacheThreadCapabilityDebugOutput false Si es true, genera registros de solución de problemas adicionales de Apache.
ApacheThreadCapabilityEnabled false Si es true, habilita la métrica de uso de subprocesos de Apache para determinar el estado de capacidad del agente.
ApacheThreadCapabilityReportInterval 2 Frecuencia para verificar el uso de subprocesos de Apache (segundos).
CapabilityDebugOutput false Si es true, genera registros de solución de problemas adicionales de capacidad.
CapabilityRefreshCooldown 1 Después de que un agente entra en estado incapaz, el período de enfriamiento (segundos) antes de actualizar el estado de capacidad. El valor predeterminado cambió de 2 a 1 en la versión 12.7 del agente.
CpuConsecutiveFailureThreshold 3 Número de violaciones consecutivas del umbral de CPU requeridas antes de que el agente cambie de capaz a incapaz. Se aplica solo cuando CpuUsageCapabilityEnabled es true. El valor predeterminado cambió de 1 a 3 en la versión 12.7 del agente.
CpuUsageCapabilityDebugOutput false Si es true, habilita los registros de depuración de capacidad de CPU en el archivo de registro del motor de procesos. Si es false, solo registra los cambios en el estado de capacidad de CPU.
CpuUsageCapabilityEnabled false Si es true, habilita la métrica IncapableCpuUsage para determinar el estado de capacidad del agente.
CpuUsageCapabilityReportInterval 1 Frecuencia para verificar el porcentaje de CPU (segundos).
EnhancedCapabilityMetricsEnabled false Si es true, habilita la lógica de métrica de capacidad del agente.
EnhancedCapabilityMetricsJMXEnabled true Si es true, habilita la métrica de JMX para la capacidad.
EnhancedCapabilityMetricsSubmissionEnabled false Si es true, establece EnhancedCapabilityMetricsEnabled en true y envía métricas de capacidad a Harmony.
IncapableCpuUsage 95 Porcentaje de CPU en el cual el agente se vuelve incapaz. Se ignora a menos que CpuUsageCapabilityEnabled sea true.
IncapableMemoryUsage 95 Porcentaje de memoria en el cual el agente se vuelve incapaz. Se ignora a menos que MemoryUsageCapabilityEnabled sea true.
MemoryUsageCapabilityDebugOutput false Si es true, genera registros de solución de problemas adicionales de memoria.
MemoryUsageCapabilityEnabled false Si es true, habilita la métrica IncapableMemoryUsage para determinar el estado de capacidad del agente.
MemoryUsageCapabilityReportInterval 1 Frecuencia para verificar el porcentaje de memoria (segundos).

[AgentMetrics]

Esta configuración se aplica solo a la función de observabilidad nativa.

Clave Predeterminado Descripción
Enabled false Si es true, permite usar otras claves en esta sección. Si es false, se ignoran los valores de otras claves en esta sección.
JitterbitMetricsServiceEnabled false Si es true, inicia el servicio de recopilación de métricas.
UserIntentFileWatcherEnabled true Si es true, y tanto Enabled como JitterbitMetricsServiceEnabled son true, inicia un servicio de supervisión de archivos que captura la última acción del usuario.
OperationStatusLogToFileEnabled false Si es true, registra el estado de las operaciones en un archivo. (Movida y renombrada de EnableAgentMetricLogging en [MetricLogging].)
OperationStatusLogToFileAsyncEnabled true Si es true, y OperationStatusLogToFileEnabled es true, registra de forma asincrónica usando subprocesos independientes. (Movida y renombrada de EnableAgentMetricLogging en [MetricLogging]) No cambies a menos que el soporte de Jitterbit te lo indique.
AgentEnvSyncProgressToFileEnabled false Si es true, registra el proceso de sincronización del agente en un archivo. (Movida y renombrada de EnableAgentSyncMetricLogging en [MetricLogging].)
SchedulerMetricThreads 100 Tamaño del grupo de subprocesos del planificador de métricas.
ProcessEngineMetricThreads Valor de MaxNumberOfWorkerThreads en [ProcessEngine] Tamaño del grupo de subprocesos del motor de procesos de métricas.
OperationEngineMetricThreads (Ninguno) Si RunOperationsInSeparateProcess=true, usa esta cantidad de subprocesos del grupo de subprocesos.

[APIInfo]

Esta configuración se aplica a operaciones activadas por una API OData de API Manager.

Clave Predeterminado Descripción
DebugJDML false Si es true, permite registros adicionales de llamadas a la API OData en API Manager, incluido el SQL enviado a la base de datos.

[APIOperation]

Estas configuraciones se aplican a operaciones activadas por un API personalizada de API Manager o un API OData.

Clave Predeterminado Descripción
EnableErrorLogging true Registra solo errores de operaciones de API en registros de operaciones. Se ignora si EnableLogging es true.
EnableLogging false Registra todas las operaciones activadas por API (exitosas y no exitosas) en registros de operaciones. Proporciona control a nivel de agente similar al habilitar registro de depuración de operaciones en operaciones individuales. Si es true, tiene prioridad sobre EnableErrorLogging. Para más detalles sobre el registro de operaciones de API, consulta Datos de solicitud y respuesta de API.
EnableOperationIdLogging false Registra el ID de una operación que causa un error.
APIOperationLogging false Registra la hora de inicio y el tiempo transcurrido de una llamada 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]

Clave Predeterminado Descripción
DeregisterAgentOnDrainstop false Anula el registro cuando se detiene el agente. Equivalente a deregisterAgentOnDrainstop en register.json.
DeregisterAgentOnJVMShutdown true Deshabilita la anulación de registro al apagar la JVM si la anulación de registro está habilitada mediante registro automático o DeregisterAgentOnDrainstop.

[ConnectorsInfo]

Clave Predeterminado Descripción
MSAXUrl http://127.0.0.1:8002/AX/ Utilizado por el conector Microsoft Dynamics AX Connector. No cambies a menos que el soporte de Jitterbit te lo indique.
MSCrmUrl http://127.0.0.1:8000/CRM/ Utilizado por el conector Microsoft Dynamics CRM Connector. No cambies a menos que el soporte de Jitterbit te lo indique.
jitterbit.connectorcall.timeout 300 Tiempo de espera de llamada de conector (segundos) para ciertos conectores. No cambies a menos que el soporte de Jitterbit te lo indique.
jitterbit.connector.disable.file.watcher false Si es true, deshabilita el monitor de archivos del conector. No cambies a menos que el soporte de Jitterbit te lo indique.
jitterbit.connector.max.recent.connector.lookup 15 Número máximo de sumas de verificación de conectores md5 a mantener. (Si la suma de verificación de un nuevo conector coincide con una existente, se omite la descarga.)
jitterbit.connector.max.temp.file.write.attempts 30 Número máximo de intentos para mover un archivo temporal de conector.

[DbDrivers]

Esta sección especifica los caracteres especiales predeterminados utilizados para delimitar nombres en algunos controladores utilizados por el conector de Base de datos. Los delimitadores compatibles incluyen: / . \* = ? | ( ) [ ] { }.

Las claves y los valores van entre comillas simples, y los caracteres especiales se escapan con \.

Clave Predeterminado
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 Description
User jitterbit Nombre de usuario para la base de datos PostgreSQL local.
DisableOdataCount false Desactiva la configuración $count e $inlinecount en consultas OData entrantes. Establece en true si la funcionalidad de conteo de la base de datos causa problemas de rendimiento.
Password None Contraseña para la base de datos PostgreSQL local. Cada instalación genera una contraseña nueva, incluso en el mismo host. La contraseña en la imagen de Docker Hub cambia entre versiones y es la misma para todos los contenedores basados en una imagen.
Driver 'PostgreSQL Unicode(x64)' Valor predeterminado de Windows.
'PostgreSQL-jitterbit' Valor predeterminado de Linux.
SystemDbName 'postgres' Nombre de la base de datos del sistema PostgreSQL.
Server 127.0.0.1 Nombre de host o dirección IP del servidor PostgreSQL.
Port 6432 Puerto del servidor PostgreSQL predeterminado. (6543 en agentes privados versión 10.60 o anteriores.)
UseInternalPooling true Si es true, habilita el pool de conexiones internas de la base de datos para optimizar el rendimiento del agente. (Esto agrupa solo la base de datos interna del agente; para agrupar conexiones de bases de datos de origen y destino, véase [SourceTargetPooling].)
  • Windows, instalación nueva (agente 12.5 en adelante): El instalador escribe esta clave con un valor de true.
  • Windows, actualización (a agente 12.5 en adelante): Si la clave no está ya definida en el archivo, el instalador solicita si desea habilitarla.
  • Linux (agente 12.9 en adelante): Si la clave no está en el archivo, el valor predeterminado es true.
  • Todos los demás casos: Si la clave no está presente, se aplica false.

[Debug]

Key Default Description
WebServiceDebugFile '' Ruta absoluta al archivo de depuración de servicios web de backend. Si es una cadena vacía, el registro se desactiva. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.

[ErrorHandling]

Esta sección configura cómo manejar posibles situaciones de error en el backend. Los valores posibles son:

  • Ok: La situación es normal; continúa como de costumbre.
  • Warning: Registra una advertencia y continúa.
  • Error: La situación es fatal.
Key Default Description
NoRowsAffectedOnDbUpdates Ok Una sentencia de actualización en un destino de base de datos que no afecta ninguna fila es Ok según la definición anterior.
NoTargetDataGenerated Ok No se generó dato destino es Ok según la definición anterior.
NoWebServiceRequestData Warning No hay datos disponibles para generar una solicitud de servicio web válida genera una Warning según la definición anterior.
EmptyDatabaseSource Warning Un origen de base de datos plano vacío genera una Warning según la definición anterior.

[FileCleanup]

Key Default Description
AutoStart true Inicia las rutinas de limpieza de archivos.
SleepTimeInSeconds 5 Tiempo de espera de limpieza de archivos (segundos).
FrequencyInHours 24.0 Intervalo de limpieza de archivos (horas).

[HttpConnectionPool]

Esta sección se utiliza con configuración de proxy para llamar recursos externos.

Key Default Description
MaxConnections 50 Número máximo de conexiones totales que se mantienen en el grupo. Si es 0 o menor, usa el valor predeterminado de la biblioteca Apache HttpClient.
MaxConnectionsPerRoute 5 Número máximo de conexiones por ruta. Si es 0 o menor, usa el valor predeterminado de la biblioteca Apache HttpClient.
TimeoutInSeconds 60 Tiempo de espera de conexión del grupo (segundos). Si es 0 o menor, usa el valor predeterminado de la biblioteca Apache HttpClient.
HttpSocketTimeoutInSeconds 180 Tiempo de espera del socket del cliente (segundos), el tiempo que el socket del cliente espera una respuesta después de establecer la conexión y enviar una solicitud. Si es 0 o menor, usa el valor predeterminado de la biblioteca Apache HttpClient.
HttpConnectionTimeoutInSeconds 180 Tiempo de espera (segundos) para esperar la conexión con el host remoto.

[HttpConnectionPoolLocal]

Esta sección se utiliza con recursos locales (servicios SOAP, API).

Key Default Description
MaxConnections 50 Número máximo de conexiones totales que se mantienen en el grupo. Si es 0 o menor, usa el valor predeterminado de la biblioteca Apache HttpClient.
MaxConnectionsPerRoute 50 Número máximo de conexiones por ruta. Si es 0 o menor, usa el valor predeterminado de la biblioteca Apache HttpClient.
TimeoutInSeconds 60 Tiempo de espera de conexión del grupo (segundos). Si es 0 o menor, usa el valor predeterminado de la biblioteca Apache HttpClient.
HttpSocketTimeoutInSeconds 180 Tiempo de espera del socket del cliente (segundos) (tiempo que el socket del cliente espera una respuesta después de establecer la conexión y enviar una solicitud). Si es 0 o menor, usa el valor predeterminado de la biblioteca Apache HttpClient.
HttpConnectionTimeoutInSeconds 180 Tiempo de espera (segundos) para esperar la conexión con el host remoto.

Consejo

Si estableces MaxConnections y MaxConnectionsPerRoute en 100, realiza estos cambios adicionales:

  1. Edita el archivo jitterbit-agent-config.properties y establece:

    max.concurrent.requests=100

  2. Edita el archivo httpd.conf y establece:

    ThreadsPerChild 101

[HttpEndPoints]

Clave Predeterminado Descripción
EnableErrorLogging true Registra errores de llamadas de puntos finales HTTP alojados en el registro de operaciones. Se ignora cuando EnableLogging es true.
EnableLogging true Registra todas las llamadas a puntos finales HTTP alojados en el registro de actividades.

[JavaBackend]

Clave Predeterminado Descripción
DebugLogLevel (Ninguno) Nivel de registro de depuración de Tomcat (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Los registros del servidor Tomcat se escriben en JITTERBIT_HOME/tomcat/logs. Consulta CleanupRules.xml para los períodos de eliminación de archivos de registro.

[JavaUiBackend]

Clave Predeterminado Descripción
LogLevel OFF Nivel de registro de la interfaz de usuario Java (Tomcat) (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Los registros del servidor Tomcat se escriben en JITTERBIT_HOME/tomcat/logs. Consulta CleanupRules.xml para los períodos de eliminación de archivos de registro.

[JDBCEngine]

Clave Predeterminado Descripción
SessionTimeout 60 Tiempo de espera de sesión JDBC abierta (minutos).
ClientSessionTimeout 180 Tiempo máximo de operación JDBC (minutos).
LogLevel INFO Nivel de registro del motor JDBC (SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, OFF, ALL). Los registros del servidor Tomcat se escriben en JITTERBIT_HOME/tomcat/logs. Consulta CleanupRules.xml para los períodos de eliminación de archivos de registro.

[JdbcSecurity]

Esta sección se agregó en la versión 12.10 del agente. Restringe las cadenas de conexión JDBC y las conexiones para el conector de Base de datos, por motivos de seguridad.

Clave Predeterminado Descripción
block.localhost.connections true Bloquea una conexión de base de datos a localhost o 127.0.0.1 cuando es true. Establece en false para permitir una conexión de base de datos a una base de datos que se ejecuta en el mismo host que el agente.
mysql.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de MySQL que siempre se rechazan.
mysql.forced.false.params Ver abajo Parámetros de cadena de conexión JDBC de MySQL que se rechazan si se establecen en true en la cadena de conexión.
postgresql.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de PostgreSQL que siempre se rechazan.
oracle.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de Oracle que siempre se rechazan.
sqlserver.blocked.params Ver abajo Parámetros de cadena de conexión JDBC de SQL Server que siempre se rechazan.

Lo siguiente muestra la sección completa con sus valores predeterminados. Para permitir una conexión o parámetro específico mientras se mantiene el resto restringido, cópialo y elimina ese parámetro del valor de la clave correspondiente:

[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 cada parámetro de una clave, establece su valor como vacío (por ejemplo, mysql.blocked.params=).

Advertencia

Comentar una de las cinco claves *.blocked.params o *.forced.false.params (con un # al inicio) no restaura su restricción predeterminada. Tiene el mismo efecto que establecer la clave en un valor vacío: se permiten todos los parámetros para esa clave. Para restaurar la restricción predeterminada después de agregar esta sección, elimina completamente la línea de la clave, o comenta la línea [JdbcSecurity] en sí, lo que restaura todas las claves en la sección a sus valores predeterminados.

[JsonParser]

Esta sección se agregó en la versión 12.5 del agente.

Clave Predeterminado Descripción
MaxStringLength 20000000 Número máximo de caracteres permitidos en un único valor de cadena JSON. Las operaciones que procesan cadenas JSON que superan este límite fallan con un error StreamConstraintsException. Aumenta este valor si necesitas procesar cargas JSON más grandes (por ejemplo, establece en 50000000 para un límite de 50 MB).

[LDAP]

Usa esta sección para agregar soporte UTF-8 para Microsoft Windows y Active Directory con agentes privados de Windows.

Clave Predeterminado Descripción
CharacterEncoding ISO-8859-1 Codificación de caracteres LDAP.

Consejo

Si utilizas la función LDAPReplace() para reemplazar un valor en un Active Directory como se muestra a continuación, es posible que descubras que el texto se convierte a un resultado diferente que la entrada, como que François se reemplace con FrançOis:

LdapReplace("givenName", "François");

En casos como este, agrega esta sección y reinicia el agente.

Para obtener más información, consulta Funciones LDAP de Studio o Funciones LDAP de Design Studio.

[Masking]

Esta sección se agregó en la versión 11.59 / 12.3 del agente. Estos parámetros se pueden usar para enmascarar encabezados de solicitud personalizados en actividades HTTP de Studio y orígenes HTTP de Design Studio y destinos. Cuando se enmascara un encabezado de solicitud, los valores enmascarados aparecen como ***REDACTED*** dentro de los registros en tiempo de ejecución.

Clave Predeterminado Descripción
HttpRequestHeaders true Si es false, los encabezados de solicitud proporcionados en RequestHeaders no se enmascaran.
RequestHeaders Lista separada por comas de encabezados de solicitud personalizados a enmascarar (por ejemplo, security_key,test_header,test_header2).

Ten en cuenta que los siguientes encabezados de solicitud ya están enmascarados de manera predeterminada en los registros en tiempo de ejecución y no requieren usar estos parámetros:

Categoría Nombre del encabezado
Autenticación y tokens authorization
proxy-authorization
x-api-key
x-auth-token
x-access-token
x-refresh-token
x-session-token
x-id-token
x-client-secret
Cookies y CSRF cookie
x-csrf-token
x-xsrf-token
PII (GDPR / CCPA) x-user-id
x-user-email
x-user-name
x-user-phone
x-user-address
x-customer-id
x-employee-id
x-national-id
x-date-of-birth
x-ip-address
x-forwarded-for
x-real-ip
x-originating-ip
Pagos (PCI-DSS) x-card-number
x-card-cvv
x-card-expiry
x-bank-account
x-payment-token
Salud (HIPAA) x-patient-id
x-medical-record
x-health-plan-id
x-diagnosis-code
Enrutamiento interno y rastreo x-internal-ip
x-backend-server
x-cluster-node
x-request-id
x-correlation-id

[MetricLogging]

Importante

Esta sección está obsoleta a partir de la versión 11.41 del agente privado y se eliminará en una versión posterior. Las claves se han movido a la sección [AgentMetrics], y algunas claves han sido renombradas. Consulta esa sección para más detalles.

Clave Predeterminado Descripción
EnableAgentMetricLogging false Si es true, se activa el registro de métricas del agente.
EnableAgentMetricAsyncLogging true Si es true, el registro se realiza de forma asincrónica. No cambies a menos que el soporte de Jitterbit te lo indique.
EnableAgentSyncMetricLogging Si es true, se activa el registro de métricas sincrónicas.
SchedulerMetricThreads 100 Tamaño del grupo de subprocesos del programador de métricas.
ProcessEngineMetricThreads Valor de MaxNumberOfWorkerThreads en [ProcessEngine] Tamaño del grupo de subprocesos del motor de procesos de métricas.
OperationEngineMetricThreads (Ninguno) Si RunOperationsInSeparateProcess=true, utiliza esta cantidad de subprocesos del grupo de subprocesos.

[OperationEngine]

Clave Predeterminado Descripción
Debug false Activa el modo de depuración. Se deben configurar tanto Debug como WriteLog con el valor 1 para que se generen registros.
AlwaysRunSuccessOperation false Ejecuta siempre las operaciones correctamente aunque no haya datos.
TemporaryStorageRootDirectory (Ninguno) Ruta absoluta al directorio raíz de almacenamiento temporal. Si no se especifica, se usa TemporaryStorage anexado al valor de TempDir (C:\Windows\Temp\jitterbit\TemporaryStorage en Windows, /tmp/jitterbit/TemporaryStorage en Linux). La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
MaxNumberOfOperationThreads (Ninguno) Número máximo de subprocesos de operación. Si no se especifica, el número de subprocesos de operación es ilimitado.
MaxOperationStackDepth 50 Número máximo de llamadas de operación sincrónicas anidadas. Si es 0 o un número negativo, el máximo es ilimitado.
MaxAsyncOperationChainLength 50 Número máximo de operaciones asincrónicas permitidas en una sola cadena (para evitar bucles de operación infinitos). Si es 0 o un número negativo, el máximo es ilimitado.
MaxAsyncOperationChainLengthOverrideAllowed true Anula la longitud máxima de la cadena de operación asincrónica estableciendo la variable Jitterbit jitterbit.operation.max_async_chain_length.
MaxSynchronousRunOperationCallsInLoop 50 (Añadido en 12.11.) Número máximo de llamadas sincrónicas a RunOperation permitidas desde dentro de un único bucle While. Si es 0 o un número negativo, el máximo es ilimitado.
MaxSynchronousRunOperationCallsInLoopOverrideAllowed true (Añadido en 12.11.) Anula el número máximo de llamadas sincrónicas a RunOperation permitidas en un bucle estableciendo la variable Jitterbit jitterbit.operation.max_sync_runop_calls_in_loop. Establécela en false para bloquear el límite a nivel de configuración del agente.
MaxSynchronousRunOperationCallsInLoopCustomError (Ninguno) (Añadido en 12.11.) Texto de error personalizado para mostrar en lugar del mensaje generado por defecto cuando se alcanza el límite. Encierra el mensaje entre comillas simples; de lo contrario, se trunca en el primer carácter de espacio en blanco. Se añade el nombre de la operación invocada (recurriendo a su GUID si no se puede resolver el nombre) a este mensaje para identificar qué operación secundaria alcanzó el límite.
AlwaysDeleteTempDir false Elimina los archivos temporales, incluso en caso de error.

Precaución

Cuando se activa el registro de depuración de operaciones, configurar este valor en true hará que los datos de entrada y salida de componentes no se generen, ya que los archivos de operación temporal se eliminarán antes de que el servicio Verbose Log Shipper pueda capturarlos.
WriteLog 0 Activa (1) o desactiva (0) mensajes de proceso adicionales tanto para operaciones de API como programadas que se escriban en el archivo de registro.

[PredefinedGlobalVariables]

Cualquier variable de Jitterbit se puede configurar en esta sección para aplicarse en todo el grupo de agentes de forma predeterminada. Para configurar una variable de Jitterbit a nivel de operación, consulta Establecer variables de Jitterbit en scripts o transformaciones.

La tabla a continuación lista ejemplos de variables de Jitterbit que se pueden configurar en esta sección. Esta lista no es exhaustiva; consulta la documentación de variables de Jitterbit para cada variable individual y conocer la descripción de cada una.

Clave Predeterminado Descripción
jitterbit.http.enable_cookies false Habilita cookies para conexiones HTTP.
jitterbit.scripting.db.auto_commit true Confirma scripts de base de datos automáticamente. Si es false, se usan transacciones de base de datos.
jitterbit.scripting.db.max_rows 10000 Número máximo de filas de base de datos afectadas. Se aplica a DBExecute, DBLookup y DBLookupAll funciones de base de datos de Studio o funciones de base de datos de Design Studio.
jitterbit.scripting.ldap.include_dn_in_results false Si es true, incluye el nombre distintivo (DN) en Active Directory.
jitterbit.scripting.ldap.max_search_results 1 Número máximo de resultados de búsqueda LDAP devueltos.
jitterbit.scripting.ldap.return_null_if_no_results false Si es true, las consultas LDAP sin registros coincidentes devuelven un único valor NULL.
jitterbit.scripting.ldap.scope 1 Habilita (1) o inhabilita (0) LDAP.
jitterbit.scripting.ldap.use_paged_search false Habilita la búsqueda LDAP paginada en scripting. Si es true, Jitterbit recupera datos en páginas y evita exceder los límites de Active Directory.
jitterbit.scripting.nesting.max 10 Número máximo de scripts anidados.
jitterbit.scripting.while.max_iterations 50000 Límite de iteración de scripts de Jitterbit.
jitterbit.source.db.preserve_char_whitespace false Preserva los espacios en blanco de carácter iniciales y finales de la base de datos de origen.
jitterbit.source.ftp.transfer_timeout 3600 Tiempo de espera de transferencia FTP de origen (segundos).
jitterbit.source.text.csv_nullable false Permite valores nulos en archivos de texto CSV.
jitterbit.target.db.include_null_in_sql_statement false Incluye null en las sentencias SQL de la base de datos de destino.
jitterbit.target.ftp.transfer_timeout 3600 Tiempo de espera de transferencia FTP de destino (segundos).
jitterbit.target.http.remove_trailing_linebreaks true Elimina saltos de línea finales antes de publicar datos de destino.
jitterbit.target.xml.num_for_bool false Si es true, representa valores booleanos XML como 0 y 1. Si es false, usa false y true.

[PredefinedServerGlobalDataElement]

Clave Predeterminado Descripción
(Definido por el usuario) (Definido por el usuario) Variables globales predefinidas personalizadas que se inicializan para cualquier operación que se inicia en el agente.

[ProcessEngine]

Clave Predeterminado Descripción
MaxNumberOfWorkerThreads auto Número de subprocesos de trabajo (1 a 200). Cuando es auto, el número es el doble del número de núcleos del procesador.
RunOperationsInSeparateProcess true Si es true, el tiempo de ejecución de la operación es ilimitado. Usa MaxOperationRuntimeSeconds para establecer un límite de tiempo de ejecución.
MaxOperationRuntimeSeconds (Ninguno) Tiempo máximo de ejecución de la operación (segundos). Se ignora si RunOperationsInSeparateProcess es false.
MaxOperationRuntimeMessage (Ninguno) Mensaje que se muestra cuando se alcanza el límite de tiempo de ejecución. Se ignora si RunOperationsInSeparateProcess es false.
EnableDebugDump false Si no se especifica, DebugDumpDir adopta como predeterminado la configuración TempDir en [Settings].
DebugDumpDir (Ninguno) Ruta absoluta al directorio de volcado de depuración. Si no se establece, se utiliza el valor de TempDir. Se ignora a menos que EnableDebugDump sea true. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.

[ResultFiles]

Clave Predeterminado Descripción
DisableSuccess false Crear archivos de éxito.
DisableFailure false Crear archivos de error.

[Scheduler]

Clave Predeterminado Descripción
AutoStart 1 Habilita (1) o deshabilita (0) el inicio automático del programador.
SleepTimeInSeconds 5 Tiempo de espera (segundos).
WriteLog 0 Habilita (1) o deshabilita (0) el registro de depuración del programador. El archivo de registro se encuentra en scheduler_debug.log en el directorio especificado por el valor de TempDir.

[Settings]

Clave Predeterminado Descripción
TempDir (Ninguno) Ruta absoluta a un directorio temporal. Si está vacío, los archivos temporales utilizan el directorio temporal del SO (%temp%\jitterbit en Windows, /tmp/jitterbit en Linux). La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
CurlDebugDir (Ninguno) Ruta absoluta al archivo de registro de curl para solicitudes FTP, SFTP, HTTP y HTTPS. Se crea un archivo por solicitud. Los nombres de archivo de registro son GUID con extensión .txt. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
CurlDefaultSSLVersionMax true Si es true, usa la opción --tls-max (aplica a curl 7.54.0 y posteriores).
EnableLocalFileLocation false Permitir la creación de archivos locales. Necesario para el conector de Almacenamiento local, archivos de activación, o carpetas de éxito/error configuradas en otros conectores.
JavaScriptMaxIterations 50000 Número máximo de iteraciones de bucle permitidas por script.
RecoverableStatusCode 500, 502, 503, 504 Cuando se establece y la opción Reintentar está seleccionada en una conexión HTTP, la actividad se recupera de los códigos de error listados e intenta nuevamente la actividad.
EnableAPITimeout false Si es true, las operaciones activadas por API Manager utilizarán la configuración de tiempo de espera de operaciones.
TargetHttpRemoveTrailingLinebreaks false Si es true, elimina CR/LF al final de las líneas en transformaciones posteriores del conector HTTP.
AllowUnsafeLegacyRenegotiation false Si es true, permite la renegociación TLS heredada no segura durante el protocolo de enlace de conexión con el servidor. Requerido para evitar el error error:0A000152:SSL routines::unsafe legacy renegotiation disabled. Compatible con agentes versión 11.39 y posteriores.
RollbackRetryEnabled true Si es true, el agente intenta nuevamente una inserción de base de datos interna incluso después de una reversión fallida, lo que coincide con el comportamiento predeterminado utilizado antes de que esta configuración se introdujera en la versión del agente 11.49. Si es false, la inserción no se intenta nuevamente después de una reversión fallida, evitando la reinserción de datos de la transacción rota. No cambies a menos que el soporte de Jitterbit te lo indique.

[Settings/XMLSchemas]

Estos parámetros definen las ubicaciones de los esquemas XML disponibles.

Clave Predeterminado
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]

Clave Predeterminado Descripción
DefaultSMTPServers (Ninguno) Lista de servidores SMTP separados por comas que utilizar cuando se envíe un mensaje de correo electrónico y el usuario no especifique servidores SMTP.
DefaultFromEmail (Ninguno) Dirección de correo electrónico que utilizar en el campo De si el usuario no la especifica.
DefaultAccount (Ninguno) Nombre de inicio de sesión para servidores SMTP que requieren autenticación.
DefaultAccountPassword (Ninguno) Contraseña para servidores SMTP que requieren autenticación.
UseSSL (Ninguno) Si es true, el servidor SMTP requiere SSL/TLS.

Nota

Los extremos creados al usar la función SendSystemEmail con DefaultSMTPServers se incluyen en informes de uso de extremos y cuentan hacia la licencia.

[SourceTargetPooling]

Estos parámetros configuran la agrupación de conexiones para conexiones de bases de datos de origen y destino, que utiliza una conexión de base de datos en Studio o un origen y destino de base de datos en Design Studio. La agrupación reutiliza conexiones JDBC entre operaciones en lugar de abrir y cerrar una nueva conexión cada vez, lo que reduce la sobrecarga de conexión y el riesgo de tiempo de espera agotado bajo carga concurrente. Esto es independiente de la agrupación de la propia base de datos interna del agente (consulta [DbInfo] UseInternalPooling). Disponible con agente versión 12.11 o posterior.

Clave Predeterminado Descripción
jdbc.hikari.enabled false Si es true, habilita la agrupación de conexiones. Si es false, las conexiones usan el mismo comportamiento que versiones del agente anteriores a 12.11: abrir y cerrar una nueva conexión para cada operación.
jdbc.hikari.maximumPoolSize 5 Conexiones máximas por grupo.
jdbc.hikari.minimumIdle 0 Número mínimo de conexiones inactivas que HikariCP intenta mantener en el grupo. Con el valor predeterminado de 0, se crean conexiones bajo demanda en lugar de precalentarlas.
jdbc.hikari.connectionTimeout 30000 Tiempo máximo (milisegundos) para esperar una conexión del grupo antes de fallar. Esto es independiente del parámetro Tiempo de espera (seg) en una conexión de base de datos en Studio o un origen y destino de base de datos en Design Studio, que continúa limitando el intento de conexión subyacente siempre que el grupo crea una nueva conexión física.
jdbc.hikari.idleTimeout 300000 Tiempo máximo (milisegundos) que una conexión puede permanecer inactiva en el grupo antes de retirarse.
jdbc.hikari.maxLifetime 1800000 Período de vida máximo (milisegundos) de una conexión agrupada antes de retirarse, incluso si está en uso.
jdbc.hikari.connectionTestQuery (Ninguno) Consulta utilizada para validar una conexión antes de devolverla del grupo. Dejada en blanco por defecto, lo que utiliza el método de validación del controlador JDBC en lugar de una consulta fija. Anular esto aplica la misma consulta a todas las bases de datos que utilizan este grupo.
jdbc.hikari.validationTimeout 5000 Tiempo máximo (milisegundos) para esperar a que se complete jdbc.hikari.connectionTestQuery.
jdbc.hikari.leakDetectionThreshold 0 Si se establece por encima de 0, milisegundos que una conexión puede estar registrada antes de que HikariCP registre una posible advertencia de fuga de conexión con un seguimiento de pila. 0 deshabilita la detección de fugas.
jdbc.hikari.poolEvictionThresholdMinutes 60 Minutos que un grupo puede permanecer inactivo con cero conexiones activas antes de ser elegible para evicción. 0 deshabilita la evicción.
jdbc.hikari.poolNamePrefix JitterbitSourceTarget Prefijo utilizado para nombrar grupos en registros y supervisión JMX.
jdbc.hikari.poolStatsEnabled true Si es true, registra estadísticas por grupo (conexiones activas, inactivas, totales y en espera) en el cronograma de mantenimiento periódico establecido por jdbc.hikari.statsInitialDelayMinutes y jdbc.hikari.statsIntervalMinutes. Este parámetro solo controla las líneas por grupo; una línea de estadísticas de grupo de conexiones agregadas separada se registra en el mismo cronograma independientemente de este parámetro.
jdbc.hikari.statsInitialDelayMinutes 5 Minutos después del inicio del agente antes de la primera ejecución de mantenimiento periódico (registro de estadísticas y evicción de grupo inactivo).
jdbc.hikari.statsIntervalMinutes 5 Minutos entre ejecuciones de mantenimiento periódico después de la primera. Debe ser un número positivo; 0 o un número negativo revierte al valor predeterminado en lugar de deshabilitar el cronograma.
jdbc.hikari.connStatsSampleRate 1 Registra 1 de cada \(N\) solicitudes de conexión exitosas por entidad de base de datos, para reducir el volumen de registro. 1 registra cada solicitud. Las solicitudes de conexión fallidas siempre se registran, independientemente de este parámetro.

[SSH]

Clave Predeterminado Descripción
PublicKeyFile (Ninguno) Ruta absoluta a tu clave pública. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Establece los permisos del archivo en solo lectura para el usuario de Jitterbit.
PrivateKeyFile (Ninguno) Ruta absoluta a tu clave privada. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Establece los permisos del archivo en solo lectura para el usuario de Jitterbit.
PrivateKeyPassphrase (Ninguno) Frase de contraseña de la clave privada. Establece los permisos del archivo en solo lectura para el usuario de Jitterbit.
Conjuntos adicionales (Ninguno) Configurado por el usuario.

Conjuntos adicionales

Para conjuntos adicionales, agrega un sufijo (por ejemplo XXX) a estas claves (para obtener PublicKeyFileXXX, PrivateKeyFileXXX, PrivateKeyPassphraseXXX), luego hazles referencia en variables de script de Jitterbit con $jitterbit.source.sftp.ssh_key_id="XXX" o $jitterbit.target.sftp.ssh_key_id="XXX".

[SSL]

Clave Predeterminado Descripción
CertificateFile (Ninguno) Ruta absoluta a tu archivo de certificado de cliente SSL. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Solo se admiten certificados y claves en formato PEM. Establece los permisos del archivo en solo lectura para el usuario de Jitterbit.
PrivateKeyFile (Ninguno) Ruta absoluta a tu clave privada. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Solo se admiten certificados y claves en formato PEM. Establece los permisos del archivo en solo lectura para el usuario de Jitterbit.
PrivateKeyPassphrase (Ninguno) Frase de contraseña de la clave privada. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente. Solo se admiten certificados y claves en formato PEM. Establece los permisos del archivo en solo lectura para el usuario de Jitterbit.
Conjuntos adicionales (Ninguno) Configurado por el usuario.

Conjuntos adicionales

Para conjuntos adicionales, agrega un sufijo (por ejemplo YYY) a estas claves (para obtener CertificateFileYYY, PrivateKeyFileYYY, PrivateKeyPassphraseYYY), luego hazles referencia en variables de script de Jitterbit con $jitterbit.target.http.ssl_cert_id = "YYY";, $jitterbit.source.http.ssl_cert_id = "YYY";, o $jitterbit.web_service_call.ssl_cert_id = "YYY";.

[TraceLogging]

Clave Predeterminado Descripción
tracelog.shipper.enabled false Si es true, habilita el registro de seguimiento del motor de operaciones en el agente.

[TransformationEngine]

Clave Predeterminado Descripción
WriteLog false Registro de depuración de transformación detallado. Si es true, se establece Debug en [OperationEngine] como true.
WriteLogDir (Ninguno) Ruta absoluta al directorio de registro. Si no se especifica, los registros se escriben en JITTERBIT_HOME/DataInterchange/Temp/Debug. Se ignora a menos que WriteLog sea 1. La ruta debe usar barras diagonales hacia adelante, incluso en Windows. El directorio debe existir y tener permisos de lectura-escritura para el agente.
ValidateXML true Validación de XML.
LdapEnableAutoUpdateMode false Habilitar modo de actualización automática de LDAP.
TimingOn false Habilita (1) o deshabilita (0) globalmente la generación de perfiles de archivos. Los archivos se escriben en JITTERBIT_HOME/DataInterchange/Temp/LOG.
AutoStreaming true Transmisión automática de transformación.
UseOldRuleForLoopOneOfXmlNode false (Usar para compatibilidad hacia atrás.)
AutoXsiNil false Establece el atributo xsi:nil="true" para elementos que son obligatorios y no están asignados en transformaciones.
DefaultEntityResolution true Habilitar análisis de tipos de IDoc.

[VerboseLogging]

Esta sección se utiliza para la generación de datos de entrada y salida de componentes cuando el registro de depuración de operación está habilitado en una operación de Studio individual.

Los datos de entrada y salida de componentes se registran en la nube de Harmony, a menos que verbose.logging.enable esté configurado en false. La configuración del registro en la nube no tiene efecto en este tipo de registro.

Esto anula la generación de datos de entrada y salida de componentes cuando se configura Enable Debug Logging Until en una operación de Studio individual, pero no impide que se generen archivos de registro de depuración de operación.

Key Default Description
verbose.logging.enable true Cuando el registro de depuración de operación está habilitado en una operación de Studio individual, escribe datos de entrada y salida de componentes en el registro de operación de Studio.
verbose.logging.commpress.folder.path (None) Comentado. No cambies a menos que el soporte de Jitterbit te lo indique. commpress (dos 'm') es una ortografía errónea conocida de esta propiedad.
verbose.logging.log.folder.path (None) Comentado. No cambies a menos que el soporte de Jitterbit te lo indique.
verbose.logging.log.file.extension .verbose Se utiliza para el registro de depuración de operación. No cambies a menos que el soporte de Jitterbit te lo indique.
verbose.logging.use.dynamic.host.for.collector.url true Se utiliza para el registro de depuración de operación. No cambies a menos que el soporte de Jitterbit te lo indique.
verbose.logging.collector.url (None) URL del servicio de recopilador de registros.

[XsltEngine]

Esta sección se agregó en la versión 12.11 del agente. Restringe las declaraciones DOCTYPE y la resolución de entidades externas al procesar la función RunXSLT, por seguridad.

Key Default Description
BlockExternalEntities true Bloquea declaraciones de entidades generales y de parámetros externas (por ejemplo, <!ENTITY name SYSTEM "...">) cuando es true.
BlockDtdDeclarations true Bloquea la entrada XML que contiene una declaración DOCTYPE cuando es true.
BlockExternalDtd true Bloquea la carga de archivos DTD externos cuando es true.
BlockUriSchemes true Bloquea llamadas a esquemas de URI externos como document('file://...') dentro de hojas de estilos XSLT cuando es true.

Para permitir este procesamiento, configura la clave correspondiente en false.