Composer의 ThingWorx 모델 정의 > 시스템 > 로그 > ThingWorx Platform 로깅에 대한 OpenTelemetry > SumoLogic에 연결
SumoLogic에 연결
다음 단계를 사용하여 SumoLogic 인스턴스에 연결합니다.
사전 요구 사항
◦ ThingWorx가 이미 실행 중이면 Tomcat 서비스를 중지합니다.
◦ Docker Engine(Docker Desktop)을 설치합니다. 자세한 내용은 Install Docker Engine을 참조하십시오.
◦ PTC 소프트웨어 다운로드 페이지에서 ThingWorx Docker 파일을 다운로드합니다. OpenTelemetry Collector docker-compose-otel-collector.override.yml 파일을 추출합니다.
◦ ThingWorx Foundation 설치를 완료합니다. 자세한 내용은 ThingWorx Docker 설정, 빌드 및 구성을 참조하십시오.
독립형 ThingWorx Docker 설정으로 SumoLogic에 연결할 OpenTelemetry Collector Docker 
1. docker-compose-otel-collector.override.yml을 엽니다.
a. x-platform section에서 다음 매개 변수를 업데이트합니다.
▪ SUMOLOGIC_SOURCE: <SUMOLOGIC_SOURCE>
▪ SUMOLOGIC_COLLECTOR: <SUMOLOGIC_COLLECTOR>
▪ ENABLE_OPENTELEMETRY_FOR_LOGGING: true
b. x-otel-collector 섹션에서 다음 매개 변수를 업데이트합니다.
▪ OTEL_COL_OTLPHTTP_EXPORTER_ENDPOINT: <ENDPOINT_URL>
2. 다음 명령을 실행하여 ThingWorx Server를 시작합니다.
docker compose -f docker-compose-postgres.yml -f -docker-compose-otel-collector.override.yml up -d
3. 로그를 관찰하려면 ThingWorx 로그에 액세스하는 방법을 참조하십시오.
고가용성 Docker 설치를 사용하여 SumoLogic에 연결할 OpenTelemetry Collector Docker 
1. 다운로드한 Docker 파일로 이동하고 지원되는 ThingWorx 데이터베이스의 클러스터 폴더를 엽니다.
2. 편집 모드에서 .env 파일을 엽니다. 예를 들어, PostgreSQL 파일은 \docker-compose-postgres-clustered\.env에 있을 수 있습니다.
3. ENABLE_OPENTELEMETRY_FOR_LOGGING을 true로 설정합니다.
4. Sumologic 구성 섹션에서 다음 매개 변수를 추가하거나 업데이트합니다.
◦ SUMOLOGIC_SOURCE: <SUMOLOGIC_SOURCE>
◦ SUMOLOGIC_COLLECTOR: <SUMOLOGIC_COLLECTOR>
5. OpenTelemetry Collector 섹션에서 다음 매개 변수를 추가하거나 업데이트합니다.
◦ OTEL_COL_OTLPHTTP_EXPORTER_ENDPOINT: <ENDPOINT_URL>
6. 다음 명령을 실행하여 ThingWorx Server를 시작합니다.
docker compose -f docker-compose-postgres.yml -f docker-compose-otel-collector.override.yml up -d
7. 로그를 관찰하려면 ThingWorx 로그에 액세스하는 방법을 참조하십시오.
* 
몇 분 동안 기다렸다가 ThingWorx Docker 파일을 통해 OpenTelemetry 이미지를 가져왔는지 확인합니다. 별도의 OpenTelemetry Collector가 실행 중이어야 합니다.
ThingWorx 로그에 액세스하는 방법 
1. ThingWorx Composer URL에 액세스합니다.
2. Composer > 하위 시스템 > LoggingSubsystem > 구성 > 로그 검색 전략 섹션으로 이동합니다.
3. 로그 검색 전략 사물 이름이 DefaultLogRetrievalStrategyThing으로 설정되어 있는지 확인합니다.
4. DefaultLogRetrievalStrategyThing 엔티티를 열고 구성 페이지로 이동합니다.
5. SumoLogic 인스턴스에 대한 검색 작업 API URL, 액세스 ID, 액세스 키 및 응답 제한 시간(초)을 업데이트합니다. 저장을 클릭합니다.
6. 확장을 가져오고 가져온 사물 형태에서 사물을 만듭니다. 사용자 정의 로그 검색 전략 사물 형태를 만드는 방법에 대한 자세한 내용은 외부 소스에서 로그를 질의하기 위한 사용자 정의 로그 검색 전략을 참조하십시오.
7. 기다렸다가 SumoLogic의 로그를 확인합니다.
8. Composer > 모니터링을 열고 특정 로그를 확인합니다.
* 
SumoLogic에서 로그를 활성화하려면 OpenTelemetry 구성을 참조하십시오.
설치 관리자를 통해 설치된 ThingWorx를 사용하여 SumoLogic에 연결할 OpenTelemetry Collector Docker 
1. 다음 환경 변수를 만듭니다.
◦ SUMOLOGIC_SOURCE: <SUMOLOGIC_SOURCE>
◦ SUMOLOGIC_COLLECTOR: <SUMOLOGIC_COLLECTOR>
◦ NAMESPACE: <NAMESPACE>
2. 고유한 docker-compose.yaml 파일을 만들고 다음 줄을 추가합니다.
version: '2.4'
services:
otel-collector:
image: otel/opentelemetry-collector-contrib:0.93.0
volumes:
- <path to the downloaded conf/otel-config.yaml file>:/config.yaml
# Configure the following files in accordance with the TLS/mTLS settings specified in the 'otel-config.yaml' file.
# - ./conf/client.crt:/client.crt
# - ./conf/client.key:/client.key
# - ./conf/server.crt:/server.crt
ports:
- 4317:4317
# - 8881:8881 # to view internal otel internal metrics
command: ["--config=/config.yaml"]
environment:
NAMESPACE: <NAMESPACE>
OTEL_COL_OTLP_RECEIVER_GRPC_ENDPOINT: 4317
OTEL_COL_OTLPHTTP_EXPORTER_ENDPOINT: <SUMOLOGIC ENDPOINT URL >
OTEL_COL_BATCH_PROCESSOR_SEND_BATCH_SIZE: 8192
OTEL_COL_BATCH_PROCESSOR_TIMEOUT: 200ms
OTEL_COL_MEMORY_LIMITER_PROCESSOR_CHECK_INTERVAL: 3s
OTEL_COL_MEMORY_LIMITER_PROCESSOR_LIMIT_PERCENTAGE: 75
OTEL_COL_MEMORY_LIMITER_PROCESSOR_SPIKE_LIMIT_PERCENTAGE: 30
OTEL_COL_OTLPHTTP_EXPORTER_RETRY_ON_FAILURE_INIT_INTERVAL: 5s
OTEL_COL_OTLPHTTP_EXPORTER_RETRY_ON_FAILURE_MAX_INTERVAL: 30s
OTEL_COL_OTLPHTTP_EXPORTER_RETRY_ON_FAILURE_MAX_ELAPSED_TIME: 300s
OTEL_COL_OTLPHTTP_EXPORTER_SENDING_QUEUE_NUM_CONSUMERS: 10
OTEL_COL_OTLPHTTP_EXPORTER_SENDING_QUEUE_SIZE: 1000
OTEL_COL_OTLPHTTP_EXPORTER_TIMEOUT: 5s
a. OTEL_COL_OTLPHTTP_EXPORTER_ENDPOINT 매개 변수에 대한 끝점 URL을 업데이트했는지 확인합니다.
b. NAMESPACE 값이 시스템 환경 변수와 동일한지 확인합니다.
c. 필수 사전 요구 사항에 언급된 대로 Docker 파일을 다운로드하고 추출한 후 <config/otel-config.yaml 파일 경로>가 실제 파일 경로로 대체되었는지 확인합니다.
4. 다음 명령을 사용하여 OpenTelemetry Collector 컨테이너를 실행합니다.
docker-compose up -d
5. ThingWorx Foundation 설치 폴더로 이동합니다.
6. 편집기에서 platform-settings.json 파일을 엽니다.
7. 다음 설정을 추가합니다.
a. BasicSettings > EnableOpenTelemetryForLogging을 true로 설정합니다.
b. 다음 섹션을 추가합니다.
"OpenTelemetrySettings": {
"BatchLogProcessorMaxQueueSize": "2048",
"BatchLogProcessorScheduledDelay": "10",
"BatchLogProcessorMaxExportBatchSize": "512",
"BatchLogProcessorExportTimeout": "1000",
"OtlpGRPCLogExporterEndpoint": "http://localhost:4317",
"OtlpGRPCEnableSSL": "false",
"OtlpGRPCTrustStorePath": "",
"OtlpGRPCTrustStorePassword": "",
"OtlpGRPCKeyStorePath": "",
"OtlpGRPCKeyStorePassword": "",
"RetryOtlpGRPCLogExporterMaxAttempts": "5",
"RetryOtlpGRPCLogExporterBackOffMultiplier": "1.5",
"RetryOtlpGRPCLogExporterInitialBackOff": "1",
"RetryOtlpGRPCLogExporterMaxBackOff": "5",
"OtlpGRPCMetricExporterEndpoint": "http://localhost:4317",
"EnableOpenTelemetryInternalMetrics": "true"
},
OtlpGRPCLogExporterEndpoint URL을 확인합니다.
8. ThingWorx Foundation Server를 시작하려면 Tomcat 서비스를 시작합니다.
9. 로그를 관찰하려면 ThingWorx 로그에 액세스하는 방법을 참조하십시오.
도움이 되셨나요?