Configuración de OpenTelemetry para el registro
Están disponibles los siguientes valores de configuración de OpenTelemetry en la sección BasicSettings del fichero platform-settings.json.
Configuración
Tipo
Valor por defecto
Descripción
EnableOpenTelemetryForLogging
BOOLEAN
false
Defina el valor en true para activar el selector OpenTelemetry.
Cuando se inicia el servidor de ThingWorx Platform, el selector OpenTelemetry establece una conexión con el servidor de ThingWorx Platform.
DisableFileLogging
BOOLEAN
false
Cuando este valor se define en true:
Los registros no se escriben en la carpeta /ThingworxStorage/logs.
Los registros no se muestran en la página Composer > Supervisión.
El usuario verá el siguiente mensaje en la página Composer > Supervisión.
Logging is disabled. Please refer to ThingWorx Platform configuration file to enable it.
Esta configuración solo detiene los registros internos de ThingWorx. Los registros configurados mediante logback.xml, como los registros externos, siguen funcionando.
Los registros Console logs y HTTP.out no se ven afectados y siguen funcionando.
Si DisableFileLogging se define en true y EnableOpenTelemetryForLogging se define en false:
El usuario verá el siguiente mensaje en la página Composer > Supervisión.
Logging is disabled. Please refer to platform configuration file to enable it.
La estrategia de recuperación de registros se definirá en DefaultLogRetrievalStrategy.
Si DisableFileLogging se define en false y EnableOpenTelemetryForLogging en true, los registros están disponibles en los ficheros de registro de ThingWorx en la plataforma y en el software de terceros integrado con OpenTelemetry.
Configuración de OpenTelemetry SDK
Están disponibles los siguientes valores de configuración de OpenTelemetry en la sección OpenTelemetrySettings del fichero platform-settings.json.
Configuración
Valor por defecto
Descripción
BatchLogProcessorMaxQueueSize
2048
El número máximo de ficheros de registros que se pueden poner en cola antes del procesamiento y exportación. Los valores más grandes aumentan el rendimiento, pero requieren más memoria.
BatchLogProcessorScheduledDelay
10 milisegundos
El número de milisegundos que el procesador espera antes de exportar un nuevo lote de registros, incluso si el lote no está lleno.
BatchLogProcessorMaxExportBatchSize
512
El número máximo de entradas de registro enviadas en un solo lote de exportación. Esta opción de configuración ayuda a controlar el tamaño de la carga útil y la utilización de la red.
BatchLogProcessorExportTimeout
1000 milisegundos
El número de milisegundos que el sistema espera a que se complete una solicitud de exportación de registros antes de que se agote el tiempo de espera.
OtlpGRPCLogExporterEndpoint
El URL de extremo de OTLP/gRPC donde ThingWorx Platform exporta registros (por ejemplo, http://localhost:4317). Necesario para la ingesta remota de registros a través del selector OpenTelemetry o cualquier back-end compatible con OTLP/gRPC.
OtlpGRPCEnableSSL
false
Permite activar o desactivar SSL/TLS para la exportación de registros de OTLP/gRPC.
true
-uses secure transmission
false-uses plaintext
OtlpGRPCTrustStorePath
N/D
La ruta al fichero truststore en la que se incluyen los certificados de confianza para validar el selector OpenTelemetry o el back-end de destino durante la comunicación SSL.
OtlpGRPCTrustStorePassword
N/D
Contraseña para acceder al truststore configurado en OtlpGRPCTrustStorePath.
OtlpGRPCKeyStorePath
N/D
La ruta al fichero de keystore en la que se incluyen el certificado de cliente y la clave privada para TLS mutuo (mTLS).
OtlpGRPCKeyStorePassword
N/D
Contraseña para acceder al keystore configurado en OtlpGRPCKeyStorePath.
RetryOtlpGRPCLogExporterMaxAttempts
5
Número máximo de reintentos cuando la exportación del registro falla debido a errores transitorios.
RetryOtlpGRPCLogExporterBackOffMultiplier
1,5
El multiplicador que se utiliza para calcular la disminución exponencial. Después de cada intento fallido de exportación de datos, el tiempo de espera aumenta por este factor.
RetryOtlpGRPCLogExporterInitialBackOff
1 segundo
La cantidad de tiempo en segundos antes del primer intento de reintento.
RetryOtlpGRPCLogExporterMaxBackOff
5 segundos
Número de segundos entre los intentos de reintento durante el retroceso exponencial.
OtlpGRPCMetricExporterEndpoint
N/D
El URL de extremo de OTLP/gRPC donde ThingWorx Platform exporta métricas (por ejemplo, http://localhost:4317). Este URL es necesaria para la ingesta de métricas a través del selector OpenTelemetry o cualquier back-end compatible con OTLP/gRPC.
EnableOpenTelemetryInternalMetrics
true
Permite enviar métricas a la plataforma de observabilidad a través del selector OpenTelemetry.
Temas relacionados
¿Fue esto útil?