로깅을 위한 OpenTelemetry 구성
다음 OpenTelemetry 구성 설정은 platform-settings.json 파일의 BasicSettings 섹션에서 제공됩니다.
설정
유형
기본값
설명
EnableOpenTelemetryForLogging
BOOLEAN
false
OpenTelemetry Collector를 활성화하려면 값을 true로 설정합니다.
ThingWorx Platform Server가 시작되면 OpenTelemetry Collector가 ThingWorx Platform Server와의 연결을 설정합니다.
DisableFileLogging
BOOLEAN
false
이 값을 true로 설정하면 다음과 같이 됩니다.
로그는 /ThingworxStorage/logs 폴더에 작성되지 않습니다.
로그는 Composer > 모니터링 페이지에 표시되지 않습니다.
Composer > 모니터링 페이지에 다음 메시지가 표시됩니다.
Logging is disabled. Please refer to ThingWorx Platform configuration file to enable it.
이 설정은 ThingWorx 내부 로그만 중지합니다. 외부 로그와 같이 logback.xml을 통해 구성된 로그는 계속 작동합니다.
Console logsHTTP.out 로그는 영향을 받지 않으며 계속 작동합니다.
DisableFileLoggingtrue로 설정되어 있고 EnableOpenTelemetryForLoggingfalse로 설정된 경우:
Composer > 모니터링 페이지에 다음 메시지가 표시됩니다.
Logging is disabled. Please refer to platform configuration file to enable it.
로그 검색 전략이 DefaultLogRetrievalStrategy로 설정됩니다.
DisableFileLoggingfalse로 설정되고 EnableOpenTelemetryForLoggingtrue로 설정된 경우 로그는 플랫폼의 ThingWorx 로그 파일과 OpenTelemetry가 통합된 타사 소프트웨어의 로그 파일에서 확인할 수 있습니다.
OpenTelemetry SDK 구성
다음 OpenTelemetry 구성 설정은 platform-settings.json 파일의 OpenTelemetrySettings 섹션에서 제공됩니다.
설정
기본값
설명
BatchLogProcessorMaxQueueSize
2048
처리 및 내보내기 전에 대기열에 추가될 수 있는 최대 로그 레코드 수입니다. 값이 클수록 처리량은 증가하지만 더 많은 메모리가 필요합니다.
BatchLogProcessorScheduledDelay
10밀리초
프로세서가 새 로그 배치를 내보내기 전에 대기하는 시간(밀리초)입니다. 배치가 가득 차지 않은 경우에도 마찬가지입니다.
BatchLogProcessorMaxExportBatchSize
512
단일 내보내기 배치에서 전송되는 최대 로그 엔트리 수입니다. 이 설정은 페이로드 크기와 네트워크 사용률을 제어하는 데 도움이 됩니다.
BatchLogProcessorExportTimeout
1000밀리초
시스템에서 제한 시간이 초과되기 전까지 로그 내보내기 요청이 완료되기를 기다리는 시간(밀리초)입니다.
OtlpGRPCLogExporterEndpoint
ThingWorx Platform이 로그를 내보내는 OTLP gRPC 끝점 URL(예: http://localhost:4317)입니다. OpenTelemetry Collector 또는 OTLP gRPC 호환 백엔드를 통한 원격 로그 수집에 필요합니다.
OtlpGRPCEnableSSL
false
OTLP gRPC 로그 내보내기에 SSL/TLS를 활성화 또는 비활성화할 수 있습니다.
true
- 보안 전송 사용
false - 일반 텍스트 사용
OtlpGRPCTrustStorePath
해당 없음
SSL 통신 중에 OpenTelemetry Collector 또는 대상 백엔드의 유효성을 검사하기 위한 신뢰할 수 있는 인증서가 포함된 신뢰 저장소 파일의 경로입니다.
OtlpGRPCTrustStorePassword
해당 없음
OtlpGRPCTrustStorePath에 구성된 신뢰 저장소에 액세스하기 위한 암호입니다.
OtlpGRPCKeyStorePath
해당 없음
상호 TLS(mTLS)에 대한 클라이언트 인증서 및 개인 키가 포함된 키 저장소 파일의 경로입니다.
OtlpGRPCKeyStorePassword
해당 없음
OtlpGRPCKeyStorePath에 구성된 키 저장소에 액세스하기 위한 암호입니다.
RetryOtlpGRPCLogExporterMaxAttempts
5
일시적인 오류로 인해 로그 내보내기가 실패할 때 재시도하는 최대 횟수입니다.
RetryOtlpGRPCLogExporterBackOffMultiplier
1.5
지수 백오프를 계산하는 데 사용되는 승수입니다. 데이터 내보내기 시도가 실패할 때마다 대기 시간이 이 계수만큼 계속 증가합니다.
RetryOtlpGRPCLogExporterInitialBackOff
1초
첫 번째 재시도 시도 전까지의 시간(초)입니다.
RetryOtlpGRPCLogExporterMaxBackOff
5초
지수 백오프 동안 재시도 간격(초)입니다.
OtlpGRPCMetricExporterEndpoint
해당 없음
ThingWorx Platform이 메트릭을 내보내는 OTLP gRPC 끝점 URL(예: http://localhost:4317)입니다. 이 URL은 OpenTelemetry Collector 또는 OTLP gRPC 호환 백엔드를 통한 메트릭 수집에 필요합니다.
EnableOpenTelemetryInternalMetrics
true
OpenTelemetry Collector를 통해 관찰성 플랫폼으로 메트릭을 전송할 수 있습니다.
관련 항목
도움이 되셨나요?