AEM용 OpenTelemetry opentelemetry-apm

Adobe이 AEM as a Cloud Service에 내장된 APM(Application Performance Monitoring) 통합을 모든 주요 모니터링 플랫폼에서 지원하는 가시성에 대한 개방형 업계 표준 접근 방식인 OpenTelemetry​(으)로 대체하고 있습니다.

현재 AEM as a Cloud Service에는 Adobe에서 전적으로 관리하는 내장된 APM 통합이 포함되어 있습니다. 해당 통합이 대체되면 OpenTelemetry 데이터를 허용하는 공급업체 플랫폼 또는 자체 호스팅(온-프레미스) OpenTelemetry 호환 백엔드인 고유한 APM 엔드포인트를 가져와야 합니다.

이 변경의 이점 benefits

개요 overview

AEM as a Cloud Service은 가시성에 대한 개방형 업계 표준 접근 방식인 OpenTelemetry를 사용하여 애플리케이션에서 원격 분석을 내보내고 선택한 APM 공급자에게 전달할 수 있습니다. 이렇게 하면 팀에서 이미 사용하고 있는 도구에서 나머지 시스템과 함께 AEM 애플리케이션을 모니터링할 수 있습니다.

이 통합을 사용하는 일반적인 이유에는 느리거나 실패한 요청 조사, 시간 경과에 따른 JVM 상태 및 리소스 사용 추적, AEM 계층에 대한 대시보드 및 경고 구축, 문제 동안 AEM 동작과 나머지 서비스의 상관 관계가 포함됩니다. 이러한 모든 작업은 팀이 이미 사용하고 있는 모니터링 도구를 종료하지 않고 수행됩니다.

다음 원격 분석이 범위 내에 있습니다.

로그 전달은(는) 기존의 별도 메커니즘을 통해 계속 지원되며 이 통합의 영향을 받지 않습니다.

원격 분석이 AEM에서 APM 플랫폼으로 흐르는 방식, 제어하는 방식, 플랫폼 선택 방법 등 작동 방식에 대해 알아보려면 자습서 OpenTelemetry를 통한 가시성을 참조하세요.

지원되는 OpenTelemetry 버전 supported-versions

OpenTelemetry 에이전트는 Cloud Service 런타임의 일부로 실행됩니다. Adobe은 이 기능을 제공하고 최신 상태로 유지하므로 직접 설치, 관리 또는 업그레이드할 필요가 없습니다. 특정 패치 버전은 Adobe이 에이전트를 업데이트할 때 변경될 수 있습니다.

지원되는 OpenTelemetry 변형 supported-variants

AEM 애플리케이션은 다음 OpenTelemetry 에이전트 변형(배포)을 사용하여 계측할 수 있으며 모두 위의 버전을 기반으로 합니다. 자세한 내용은 각 프로젝트의 설명서를 참조하십시오.

기본 업스트림 변형은 모든 APM 공급업체와 작동합니다. Grafana 및 Splunk 변형은 해당 플랫폼에 대한 공급업체별 계기 및 기본값을 추가합니다. Adobe은 배포 시 AEM 컨테이너에 선택한 에이전트 변형을 설치합니다. 제한된 가용성에서는 업스트림 변형이 기본적으로 사용됩니다. Grafana 또는 Splunk 변형을 사용하려면 액세스 요청할 때 요청하십시오. config/otel.yaml 파일은 원격 분석 위치를 구성합니다. 에이전트 변형을 선택할 수 있는 필드가 없습니다.

APM 공급업체 apm-vendors

OTLP/HTTPS​을(를) 통해 OpenTelemetry 데이터를 수락하는 모든 응용 프로그램 성능 모니터링 공급업체에 원격 분석을 보낼 수 있습니다. 선택한 OpenTelemetry 변형과는 독립적입니다. OTLP/HTTPS를 지원하는 공급업체는 다음과 같습니다.

이 목록은 완전하지 않습니다. OTLP/HTTPS 끝점을 노출하는 백엔드를 사용할 수 있습니다.

지원되는 환경 supported-environments

Cloud Manager 프로덕션, 스테이징 및 개발 환경에서 이 통합을 활성화할 수 있습니다. 각 환경은 개별적으로 사용할 수 있습니다. 1단계를 참조하십시오. RDE(신속한 개발 환경)는 지원되지 않습니다.

기존 APM 통합 existing-apm

OpenTelemetry는 동일한 환경에서 다른 APM 에이전트와 함께 실행할 수 없습니다.

네트워크 연결 network-connectivity

HTTPS를 통해 AEM as a Cloud Service 환경에서 APM 공급자의 엔드포인트에 연결할 수 있어야 합니다.

APM 끝점이 비공개이거나 안정적이고 알려진 IP 주소에서 나가기 위해 아웃바운드 트래픽이 필요한 경우 이 통합은 전용 이그레스를 사용하는 고급 네트워킹​을 지원합니다. 사용 방법은 고급 네트워킹을 참조하세요.

전송된 데이터 what-data-is-sent

AEM 응용 프로그램​에서 생성한 추적, 지표 및 (활성화된 경우) 로그만 APM 공급자에게 전송됩니다. 다음 예제는 예상할 수 있는 데이터 종류를 보여 줍니다.

추적 — 다음을 포함하여 응용 프로그램에서 처리하는 요청에 대한 범위입니다.

대량의 내부 스케줄러 및 상태 검사 활동(예: Quartz 작업)을 필터링하여 추적이 애플리케이션 요청에 초점을 맞추도록 합니다.

지표 — 표준 OpenTelemetry 지표 이름을 사용하는 JVM 런타임 및 HTTP 서버 지표와 aem. 접두사의 AEM 지표(롤아웃되고 있으며 구성 변경 없이 자동으로 표시됨)를 포함합니다.

로그 — 활성화되면 OpenTelemetry의 로그 신호를 사용하여 보낸 AEM 응용 프로그램의 WARN 수준 이상의 로그 항목입니다. 이 로그 수준을 조정하는 기능은 개발 중입니다. 로그 항목은 추적 및 지표(service.name, deployment.environment)와 동일한 리소스 특성 및 이들을 생성한 요청의 추적 및 범위 식별자를 전달하므로 추적과 상관 관계가 있을 수 있습니다.

이러한 방식으로 전송된 로그는 로그 전달과(와) 독립적입니다. 동일한 대상에 두 항목을 모두 활성화하면 중복 문제가 발생하는 이유는 개요를 참조하십시오.

원격 분석 식별 방법 — 각 추적 및 지표는 다음을 포함하여 해당 소스를 식별하는 리소스 특성을 전달합니다.

내부 호스트 이름, 주소, 컨테이너 식별자, 운영 체제 또는 프로세스 세부 정보 등, Cloud Service 런타임 및 애플리케이션을 호스팅하는 플랫폼에 대한 정보는 데이터가 환경을 떠나기 전에 제거됩니다.

통합 설정 set-up

Cloud Manager에 자격 증명을 저장하는 것부터 관찰 가능성 플랫폼에서 원격 분석을 확인하는 것에 이르기까지 WKND 샘플 프로젝트를 사용하는 안내식 연습에 대해서는 AEM 애플리케이션에 대한 통찰력을 위한 OpenTelemetry 구성 자습서를 참조하십시오.

1단계: 액세스 요청 request-access

Cloud Manager 프로그램 ID와 활성화할 환경 ID를 사용하여 aemcs-apm-beta@adobe.com에 전자 메일을 보내십시오. 기본값이 아닌 Grafana 또는 Splunk 에이전트 변형을 사용하려면 전자 메일에서 그렇게 말하십시오(지원되는 OpenTelemetry 변형 참조).

Adobe은 요청에 응답한 직후 해당 환경에 대한 OpenTelemetry를 활성화합니다. 현재 환경에서 Adobe의 기본 제공 APM 통합을 사용하는 경우 OpenTelemetry가 활성화되면 해당 통합은 데이터 전송을 중지합니다. 기존 APM 통합을 참조하십시오.

2단계: 구성 파일 추가 add-configuration

Cloud Manager 구성 파이프라인 저장소에 config/otel.yaml 파일을 추가합니다. 최소한 다음 사항을 지정하십시오.

New Relic, Dynatrace, Grafana Cloud, Splunk, Datadog, Dash0 및 제네릭 또는 자체 호스팅되는 끝점에 대한 예제를 포함하여 정확한 파일 형식은 아래의 예제 구성을 참조하십시오.

3단계: 인증 자격 증명 구성 configure-credential

Cloud Manager에서 이름이 OTEL_CUSTOMER_AUTH인 비밀 환경 변수을(를) 선언하여 APM 공급자에 필요한 자격 증명을 제공하십시오. 자격 증명을 작성자, 게시 및 미리보기 계층에서 사용할 수 있도록 서비스 적용됨​을(를) 모두(으)로 설정하십시오.

환경 변수를 추가하거나 업데이트하려면 배포 관리자 역할의 멤버여야 합니다. 전체 프로시저는 Cloud Manager의 환경 변수를 참조하십시오.

공급자의 인증 방법에 따라 값을 설정합니다.

공급자별 설정 provider-specific

다음 표에는 일부 일반 공급자에 대한 엔드포인트 및 인증이 요약되어 있습니다. 공급자의 자체 설명서에서 항상 현재 값을 확인합니다. 사용자 지정 헤더를 사용하는 공급자(예: New Relic 및 Datadog)의 경우 OTEL_CUSTOMER_AUTH을(를) 원시 키 값으로만 설정하고 구성 파일의 authHeaderName을(를) 올바른 헤더 이름으로 설정합니다(구성 예제 참조).

예제 구성 example-configuration

공급자별 설정의 공급자를 기반으로 구성 파이프라인 저장소의 config/otel.yaml에 다음 예제 중 하나와 같은 파일을 추가하십시오.

New Relic:

kind: "Otel"
version: "1"
metadata:
  envTypes:
    - "stage"
    - "prod"
data:
  enabled: true
  type: "newrelic"
  endpoint: "https://otlp.nr-data.net"   # https://otlp.eu01.nr-data.net for the EU region
  authHeaderValue: "${{secrets.OTEL_CUSTOMER_AUTH}}"
  metrics: true   # optional
  logs: true      # optional — see Overview for the Log Forwarding duplicate-message warning

Dynatrace:

kind: "Otel"
version: "1"
metadata:
  envTypes:
    - "stage"
    - "prod"
data:
  enabled: true
  type: "dynatrace"
  endpoint: "https://{your-environment-id}.live.dynatrace.com/api/v2/otlp"
  authHeaderValue: "${{secrets.OTEL_CUSTOMER_AUTH}}"   # the secret's value must be "Api-Token <token>"
  metrics: true
  logs: true

데이터 집합:

kind: "Otel"
version: "1"
metadata:
  envTypes:
    - "stage"
    - "prod"
data:
  enabled: true
  type: "generic"
  endpoint: "https://otlp.<your-datadog-site>"   # for example, https://otlp.datadoghq.com
  authHeaderName: "dd-api-key"
  authHeaderValue: "${{secrets.OTEL_CUSTOMER_AUTH}}"   # the secret's value is the raw API key, no prefix
  metrics: true
  logs: true

Dash0:

kind: "Otel"
version: "1"
metadata:
  envTypes:
    - "stage"
    - "prod"
data:
  enabled: true
  type: "generic"
  endpoint: "https://ingress.<region>.aws.dash0.com:4318"
  authHeaderValue: "${{secrets.OTEL_CUSTOMER_AUTH}}"   # the secret's value must be "Bearer <token>"
  metrics: true
  logs: true

Grafana 클라우드:

kind: "Otel"
version: "1"
metadata:
  envTypes:
    - "stage"
    - "prod"
data:
  enabled: true
  type: "grafana"
  endpoint: "https://otlp-gateway-<zone>.grafana.net/otlp"   # for example, https://otlp-gateway-prod-us-east-0.grafana.net/otlp
  authHeaderValue: "${{secrets.OTEL_CUSTOMER_AUTH}}"   # the secret's value must be "Basic <base64(instanceID:token)>"
  metrics: true
  logs: true

Splunk(게이트웨이로 실행 중인 OpenTelemetry Collector의 Splunk 배포를 통해):

kind: "Otel"
version: "1"
metadata:
  envTypes:
    - "stage"
    - "prod"
data:
  enabled: true
  type: "splunk"
  endpoint: "https://<your-splunk-otel-collector>:4318"
  authHeaderValue: "${{secrets.OTEL_CUSTOMER_AUTH}}"   # the credential your gateway accepts, for example "Bearer <token>"
  metrics: true
  logs: true

일반 또는 자체 호스팅 끝점(예: 온-프레미스 OpenTelemetry 수집기):

kind: "Otel"
version: "1"
metadata:
  envTypes:
    - "stage"
    - "prod"
data:
  enabled: true
  type: "generic"
  endpoint: "https://<your-otlp-endpoint>"
  authHeaderValue: "${{secrets.OTEL_CUSTOMER_AUTH}}"   # for example, "Basic <base64(user:pass)>"
  metrics: true
  logs: true

고급 네트워킹(전용 이그레스) — 전용 끝점이거나 알려진 안정적인 IP 주소에서 트래픽이 나가도록 하는 끝점입니다(네트워크 연결 참조).

kind: "Otel"
version: "1"
metadata:
  envTypes:
    - "stage"
    - "prod"
data:
  enabled: true
  type: "generic"
  endpoint: "https://<your-private-otlp-endpoint>"
  authHeaderValue: "${{secrets.OTEL_CUSTOMER_AUTH}}"
  metrics: true
  logs: true
  advancedNetworking: true   # routes this endpoint's egress through Advanced Networking instead of direct internet egress

4단계: 배포 deploy

Adobe에서 OpenTelemetry가 환경에 대해 활성화되어 있음을 확인했으면(1단계 참조) 구성 파이프라인을 실행하여 config/otel.yaml을(를) 배포하십시오. 파이프라인은 구성을 확인하고 구성을 적용하기 전에 엔드포인트 및 자격 증명을 확인하므로 대부분의 실수가 파이프라인 로그에 직접 보고됩니다.

파이프라인이 완료되면 AEM 애플리케이션의 추적, 지표 및 (활성화된 경우) 로그가 APM 공급자에 나타나기 시작합니다. 5단계를 사용하여 확인하세요.

5단계: 통합 확인 verify

원격 분석이 자신의 APM 공급자에게 전송되므로 공급자의 도구에서 통합을 확인합니다. Adobe에서는 이 데이터를 다시 사용자에게 표시하지 않습니다.

파이프라인이 완료된 후 데이터가 도착할 때까지 몇 분 정도 기다린 후 APM 공급자에게 다음 사항을 확인하십시오.

이 데이터가 나타나면 통합이 작동합니다.

문제 해결 troubleshooting

원격 분석이 APM 공급자에 나타나지 않으면 다음을 확인하십시오.

이러한 확인 후에도 원격 분석이 나타나지 않으면 aemcs-apm-beta@adobe.com에 프로그램 및 환경 세부 정보를 문의하십시오.

FAQ faq

변경 사항이 발생하는 이유는 무엇입니까?

AEM as a Cloud Service 고객은 추가 지표 및 운영 데이터와 더불어 컨텍스트에서 추적, 범위 및 로그를 요청했습니다. OpenTelemetry는 이러한 모든 기능을 지원하는 업계 표준으로 널리 지원되는 형식(OTLP)으로 출력됩니다.

액세스 권한을 요청해야 합니까?

예. 제한된 시간 동안 프로그램 및 환경 ID를 사용하여 aemcs-apm-beta@adobe.com에 전자 메일을 보내십시오. Adobe은 요청에 응답한 직후 해당 환경에 대한 OpenTelemetry를 활성화합니다. HIPAA 범위 환경에서는 아직 사용할 수 없습니다.

OpenTelemetry를 활성화하면 New Relic이 어떻게 됩니까?

Adobe이 요청에서 환경에 대한 OpenTelemetry를 활성화하면 데이터가 더 이상 해당 환경에서 New Relic으로 전송되지 않습니다. 두 항목을 동시에 실행할 수 없습니다.

New Relic에서 OpenTelemetry로 마이그레이션하는 경우 다시 이동할 수 있습니까?

예. 전자 메일 aemcs-apm-beta@adobe.com 및 Adobe이 환경에 대한 OpenTelemetry를 사용하지 않도록 설정합니다. 그런 다음 config/otel.yaml 파일에서 enabled: false을(를) 설정하거나 파일을 제거하고 구성 파이프라인을 실행하고 전체 스택 파이프라인을 실행하여 New Relic 복원을 완료합니다. 이는 2026년 11월 말까지 가능합니다.

내 환경에서 Dynatrace OneAgent를 실행하는 경우 OpenTelemetry를 사용할 수 있습니까?

동일한 환경에 있지 않음 — Dynatrace OneAgent가 우선합니다. OneAgent를 제거하고 대신 OpenTelemetry를 사용할 수 있습니다(APM 공급자로 Dynatrace 포함). 기존 APM 통합을 참조하십시오.

2026년 11월 이후에 수행되는 작업

Adobe은 내장된 APM 솔루션에서 영구적인 가시성 솔루션으로 OpenTelemetry로 이전할 예정입니다.

관련 문서 related-articles