데이터 수집에 대한 디버그 로깅 활성화

다음 메서드는 웹 SDK 진단 출력을 제어합니다. 독립 실행형 웹 SDK 구현에 대해 태그 라이브러리 로깅을 활성화하지 않습니다.

configure 명령의 debugEnabled: 기존 configure 호출에서 debugEnabled을(를) true(으)로 설정합니다. 이 설정은 개발 환경에서 유용합니다. 사이트의 코드에 배포되는 경우 해당 구성을 실행하는 방문자에 대해 로깅이 활성화됩니다.

alloy("configure", {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  debugEnabled: true
});

구성 값을 false(으)로 변경하거나 이후 배포에서 생략하여 기본값을 복원합니다. 로깅을 전환하려면 동일한 인스턴스에서 configure을(를) 두 번 실행하지 말고 대신 setDebug을(를) 사용하십시오. 로컬 디버그 재정의는 구성 값보다 우선할 수 있습니다. 구성 참조에 대해서는 debugEnabled을(를) 참조하십시오.

setDebug 명령: 브라우저 콘솔에서 적절한 웹 SDK 인스턴스에 대해 명령을 실행합니다.

alloy("setDebug", { enabled: true });

완료되면 비활성화합니다.

alloy("setDebug", { enabled: false });

콘솔에서 이 명령을 실행하면 다른 방문자의 브라우저가 아니라 로컬 인스턴스가 변경됩니다. 배포된 사이트 코드에 동일한 명령을 입력하면 해당 코드를 실행하는 방문자에게 영향을 줍니다. 로컬 재정의는 브라우저 저장소를 사용할 수 있을 때 동일한 원본 탭 세션에서 해당 인스턴스에 대한 페이지 로드 간에 지속될 수 있습니다. 자세한 내용은 setDebug을(를) 참조하십시오.

alloy_debug 쿼리 문자열 매개 변수: 페이지 URL에 alloy_debug=true을(를) 추가한 다음 페이지를 로드합니다.

https://example.com/?alloy_debug=true

URL에 이미 쿼리 매개 변수가 있는 경우 &alloy_debug=true을(를) 사용합니다. 이 매개 변수를 사용하면 배포된 코드를 변경하지 않고 로컬에서 로깅할 수 있습니다. Web SDK은 각 인스턴스가 생성될 때 매개 변수를 읽으므로 페이지의 모든 웹 SDK 인스턴스에 적용됩니다. 브라우저 저장소를 사용할 수 있는 경우 탭의 동일 원본 세션 동안 설정이 유지되므로 매개 변수를 제거해도 로깅이 비활성화되지 않습니다. 페이지를 alloy_debug=false(으)로 로드하거나 setDebug(으)로 enabled: false(으)로 실행하여 비활성화합니다. URL에 alloy_debug=true이(가) 여전히 포함되어 있는 경우 다시 로드하면 로깅이 다시 활성화됩니다.

Adobe Experience Platform Debugger: Adobe Experience Platform Debugger을 열고 웹 SDK 섹션을 선택한 다음 구성 탭에서 디버깅을 사용하도록 설정합니다. 완료하면 옵션을 끕니다.

이 절차를 통해 진단 출력을 사용할 수 있습니다. 요청이나 Edge 검사에 디버거를 사용하는 방법은 데이터 수집 요청 검사에서 다룹니다.

태그 라이브러리가 있는 페이지에서 브라우저 콘솔에서 다음을 실행합니다.

_satellite.setDebug(true);

이 명령은 _satellite.logger 출력을 포함하여 태그 라이브러리 메시지를 표시합니다. Web SDK 태그 확장 기능으로 관리되는 웹 SDK 인스턴스의 경우 확장 기능은 SDK을 구성할 때 태그 디버그 모드를 사용하고 후속 디버그 모드 변경 사항을 해당 인스턴스에 전달합니다. 독립 실행형 또는 외부에서 구성된 웹 SDK 인스턴스에 대해 디버깅을 켜면 태그 로깅도 사용된다고 가정하지 마십시오.

웹 SDK 태그 확장은 태그 구성 UI에 디버그 토글을 제공하지 않습니다. 확장 관리 인스턴스에 대해 콘솔 메서드를 사용합니다. 태그 규칙에 맞지 않도록 합니다.

태그 디버그 모드 및 해당 확장 관리 SDK 로깅을 비활성화하려면 다음을 수행하십시오.

_satellite.setDebug(false);

태그 디버그 모드는 페이지의 출처에 대한 브라우저의 로컬 저장소에 저장됩니다. 페이지 로드 및 브라우저 다시 시작에 걸쳐 사이트를 비활성화하거나 사이트의 데이터를 지울 때까지 지속되며 다른 방문자에 대한 로깅을 활성화하지 않습니다. 범위 및 지속성 세부 정보는 _satellite.setDebug()을(를) 참조하십시오.

태그 라이브러리는 태그 디버그 모드가 변경될 때만 확장에 알립니다. 태그 디버그 모드가 이미 켜져 있지만 웹 SDK 메시지가 없는 경우 setDebug 또는 alloy_debug에서 웹 SDK 재정의로 인해 SDK 로깅이 해제되었을 수 있습니다. _satellite.setDebug(false)을(를) 실행한 다음 _satellite.setDebug(true)을(를) 실행하거나 재정의를 설정하는 동일한 웹 SDK 메서드를 사용합니다.

Server SDK은(는) 방문자의 브라우저가 아닌 서버 콘솔에 진단 출력을 기록합니다.

인스턴스 및 해당 구성에서 만든 forRequest 핸들에 대한 로깅을 사용하도록 설정하려면 기존 서버측 configure 호출에서 debugEnabled: true을(를) 설정하십시오. 기본값은 false입니다. 전체 구성 예제는 debugEnabled을(를) 참조하십시오.

대상 조사를 수행하려면 forRequest에서 반환된 요청 범위 핸들에서 setDebug을(를) 호출하십시오. 해당 핸들에 대해서만 변경 사항을 기록하므로 모든 방문자에 대해 활성화하지 않고 단일 요청을 디버깅할 수 있습니다.

const visitor = alloy.forRequest({ request: req });

await visitor.setDebug({ enabled: true });
await visitor.sendEvent({
  xdm: { eventType: "web.webpagedetails.pageViews" }
});

최상위 인스턴스에서 setDebug을(를) 호출하면 해당 인스턴스에서 직접 수행한 호출에 대해서만 로깅되고, 요청 핸들에 대해서는 로깅되지 않습니다. 비활성화하거나 프로세스가 다시 시작될 때까지 로깅되지 않습니다. 모든 요청 핸들의 기준선을 변경하려면 서버 구성에서 debugEnabled을(를) 업데이트하십시오.

메시지는 [alloy]과(와) 같이 대괄호로 묶인 인스턴스를 식별하며 구성, 메서드 입력/결과, 경고 및 오류를 포함합니다. 호스팅 환경에서 라우팅되는 서버 프로세스의 출력 또는 로그 대상을 검토합니다.

Mobile Core의 setLogLevel API를 사용하여 진단 정확도를 선택합니다. Android의 기본값은 LoggingMode.ERROR이고, iOS의 기본값은 LogLevel.error입니다. 앱을 초기화하는 동안 원하는 수준을 설정한 후 문제를 재현합니다.

Android: 개발 앱에서 자세한 로깅을 사용하도록 설정합니다.

import com.adobe.marketing.mobile.LoggingMode
import com.adobe.marketing.mobile.MobileCore

MobileCore.setLogLevel(LoggingMode.VERBOSE)

실행 중인 앱 프로세스에 대한 Android Studio의 Logcat​에서 출력을 봅니다. 모바일 SDK 메시지는 AdobeExperienceSDK 태그를 사용하므로 tag:AdobeExperienceSDK(으)로 필터링하고 로그 뷰어에서 디버그 및 자세한 메시지를 허용하는지 확인하십시오. 완료되면 오류 수준 로깅 복원:

MobileCore.setLogLevel(LoggingMode.ERROR)

iOS: 개발 앱에서 추적 로깅 사용:

import AEPCore
import AEPServices

MobileCore.setLogLevel(.trace)

Xcode에서 실행 중인 앱 콘솔을 보고 AEP SDK을(를) 필터링합니다. 완료되면 오류 수준 로깅 복원:

MobileCore.setLogLevel(.error)

오류 레벨로 돌아가면 진단 출력이 감소하므로 오류가 억제되지 않습니다. 이러한 호출은 다른 설치가 아니라 실행 중인 앱의 로깅을 변경합니다. 초기화 코드가 다음 실행 시 또는 프로덕션 빌드에서 자세한 로깅을 다시 활성화하지 않는지 확인합니다.

Java, Objective-C, 지원되는 수준 및 버전별 세부 정보에 대해서는 Mobile Core API 참조를 참조하십시오. React Native 또는 Flutter의 경우 네이티브 호출을 래퍼 코드에 직접 복사하지 말고 Mobile SDK 래퍼에 의해 노출된 API를 사용하십시오. 런타임 콘솔 출력이 아닌 연결된 이벤트 검사에 대해서는 Assurance을 참조하십시오.