예약된 쿼리 모니터링
Adobe Experience Platform은 UI를 통해 모든 쿼리 작업의 상태에 대한 향상된 가시성을 제공합니다. 이제 예약된 쿼리 탭에서 쿼리 실행에 실패한 경우 상태, 일정 세부 정보 및 오류 메시지/코드를 포함하는 중요한 정보를 찾을 수 있습니다. 예약된 쿼리 탭을 통해 이러한 쿼리의 UI를 통해 해당 상태에 따라 쿼리에 대한 알림을 구독할 수도 있습니다.
예약된 쿼리
예약된 쿼리 탭은 모든 예약된 CTAS 및 ITAS 쿼리에 대한 개요를 제공합니다. 모든 예약된 쿼리와 실패한 쿼리에 대한 오류 코드 및 메시지에 대한 실행 세부 정보를 찾을 수 있습니다.
예약된 쿼리 탭으로 이동하려면 왼쪽 탐색 막대에서 쿼리 를 선택한 다음 예약된 쿼리 를 선택합니다
아래 표에서는 사용 가능한 각 열에 대해 설명합니다.
노트
| 열 | 설명 |
|---|---|
| 이름 | 이름 필드는 템플릿 이름 또는 SQL 쿼리의 처음 몇 문자입니다. UI를 통해 쿼리 편집기로 만든 모든 쿼리의 이름은 처음 만들 때 로 지정됩니다. API를 통해 쿼리를 만든 경우 해당 이름은 쿼리를 만드는 데 사용되는 초기 SQL 코드 조각이 됩니다. 쿼리와 연결된 모든 실행 목록을 보려면 이름 열에서 항목을 선택하십시오. 자세한 내용은 쿼리 실행 일정 세부 정보 섹션을 참조하십시오. |
| 템플릿 | 쿼리의 템플릿 이름입니다. 템플릿 이름을 선택하여 쿼리 편집기로 이동합니다. 쿼리 템플릿은 편의를 위해 쿼리 편집기에 표시됩니다. 템플릿 이름이 없는 경우 행은 하이픈으로 표시되며 쿼리를 보기 위해 쿼리 편집기로 리디렉션할 수 없습니다. |
| SQL | SQL 쿼리의 코드 조각입니다. |
| 실행 빈도 | 쿼리가 실행되도록 설정된 케이던스입니다. 사용 가능한 값은 Run once 및 Scheduled입니다. |
| 만든 사람 | 쿼리를 만든 사용자의 이름입니다. |
| 생성일 | 쿼리가 생성된 타임스탬프(UTC 형식)입니다. |
| 마지막 실행 타임스탬프 | 쿼리가 실행된 가장 최근 타임스탬프입니다. 이 열에서는 쿼리가 현재 예약에 따라 실행되었는지 여부를 강조 표시합니다. |
| 마지막 실행 상태 | 가장 최근 쿼리 실행의 상태입니다. 상태 값은 Success, Failed, In progress 및 No runs입니다. |
| 예약 상태 |
예약된 쿼리의 현재 상태입니다. 6개의 잠재적 값이 있습니다. 등록, 활성, 비활성, 삭제됨, 하이픈 및 격리됨.
|
팁예약된 쿼리에 대한 표 설정 사용자 지정
필요에 따라 예약된 쿼리 탭의 열을 조정할 수 있습니다. 표 사용자 지정 설정 대화 상자를 열고 사용 가능한 열을 편집하려면 설정 아이콘(
노트
관련 확인란을 전환하여 테이블 열을 제거하거나 추가합니다. 그런 다음 적용 을 선택하여 선택 항목을 확인합니다.
노트
인라인 작업으로 예약된 쿼리 관리
예약된 쿼리 보기는 한 위치에서 모든 예약된 쿼리를 관리하기 위한 다양한 인라인 작업을 제공합니다. 인라인 작업은 줄임표가 있는 각 행에 표시됩니다. 관리할 예약된 쿼리의 줄임표를 선택하여 팝업 메뉴에서 사용 가능한 옵션을 확인합니다. 사용 가능한 옵션에는 일정 비활성화 또는 일정 활성화, 일정 삭제, 경고를 쿼리하기 위한 구독 및 격리 활성화 또는 비활성화가 있습니다.
예약된 쿼리 비활성화 또는 활성화
예약된 쿼리를 비활성화하려면 관리할 예약된 쿼리의 줄임표를 선택한 다음 팝업 메뉴의 옵션에서 일정 비활성화 를 선택합니다. 작업을 확인하는 대화 상자가 나타납니다. 설정을 확인하려면 사용 안 함 을 선택하세요.
예약된 쿼리가 비활성화되면 동일한 프로세스를 통해 일정을 활성화할 수 있습니다. 줄임표를 선택한 다음 사용 가능한 옵션에서 일정 활성화 를 선택합니다.
노트예약된 쿼리 삭제
예약된 쿼리를 삭제하려면 관리하려는 예약된 쿼리의 줄임표를 선택한 다음 팝업 메뉴의 옵션에서 일정 삭제 를 선택합니다. 작업을 확인하는 대화 상자가 나타납니다. 설정을 확인하려면 삭제 를 선택하세요.
예약된 쿼리가 삭제되면 예약된 쿼리 목록에서 제거되지 않습니다. 타원에서 제공한 인라인 작업은 제거되고 회색으로 표시된 경고 구독 추가 아이콘으로 바뀝니다. 삭제된 일정에 대한 경고는 구독할 수 없습니다. 행은 예약된 쿼리의 일부로 수행된 실행에 대한 정보를 제공하기 위해 UI에 유지됩니다.
해당 쿼리 템플릿에 대한 실행을 예약하려면 해당 행에서 템플릿 이름을 선택하여 쿼리 편집기로 이동한 다음, 설명서에 설명된 대로 지침에 따라 쿼리에 일정을 추가합니다.
경고 구독
예약된 쿼리 실행에 대한 경고를 구독하려면 ...(줄임표) 또는 경고 구독 아이콘(
경고 대화 상자가 열립니다. 알림 대화 상자는 UI 알림과 전자 메일 알림을 모두 구독합니다. 사용 가능한 경고 구독 옵션에는 start, success, failure, quarantine 및 delay이(가) 있습니다. 해당 확인란을 선택하고 저장 을 선택하여 구독하세요.
아래 표에서는 지원되는 쿼리 경고 유형에 대해 설명합니다.
| 경고 유형 | 설명 |
|---|---|
start | 이 경고는 예약된 쿼리 실행이 시작되거나 처리를 시작할 때 알려줍니다. |
success | 이 경고는 예약된 쿼리 실행이 성공적으로 완료되면 사용자에게 알려 주며 이는 쿼리가 오류 없이 실행되었음을 나타냅니다. |
failed | 이 경고는 예약된 쿼리 실행에 오류가 발생하거나 성공적으로 실행되지 않을 때 트리거됩니다. 문제를 신속하게 식별하고 해결하는 데 도움이 됩니다. |
quarantine | 이 경고는 예약된 쿼리 실행이 격리된 상태로 전환되면 활성화됩니다. 쿼리가 격리 기능에 등록되면 10번의 연속 실행에 실패한 예약된 쿼리는 자동으로 격리됨 상태가 됩니다. 그런 다음 추가 실행이 수행되기 전에 사용자의 개입이 필요합니다. |
delay | 이 경고는 지정된 임계값을 초과하는 쿼리 실행 결과에 지연이 있을 경우을(를) 알려 줍니다. 완료하거나 실패하지 않고 해당 기간 동안 쿼리가 실행될 때 경고를 트리거하는 사용자 지정 시간을 설정할 수 있습니다. |
노트자세한 내용은 경고 구독 API 설명서를 참조하세요.
쿼리 세부 정보 보기
정보 아이콘(
격리된 쿼리
노트격리 기능에 등록되면 10번의 연속 실행에 실패한 모든 예약된 쿼리는 자동으로 격리됨 상태로 전환됩니다. 이 상태의 쿼리는 비활성화되고 예약된 케이던스로 실행되지 않습니다. 그런 다음 더 이상의 실행이 수행되기 전에 사용자의 개입이 필요합니다. 이렇게 하면 추가 실행이 발생하기 전에 SQL 문제를 검토하고 수정해야 하므로 시스템 리소스를 보호합니다.
격리 기능에 대해 예약된 쿼리를 활성화하려면 표시되는 드롭다운 메뉴에서 줄임표(...)와 격리 활성화를 차례로 선택합니다.
일정 생성 프로세스 중에 쿼리를 격리 기능에 등록할 수도 있습니다. 자세한 내용은 쿼리 일정 설명서를 참조하세요.
쿼리 실행 지연
쿼리 지연에 대한 경고를 설정하여 컴퓨팅 시간을 제어할 수 있습니다. 특정 기간 후에도 쿼리 상태가 변경되지 않은 경우 쿼리 성능을 모니터링하고 알림을 받을 수 있습니다. 쿼리가 완료되지 않고 특정 기간 후에도 계속 처리되는 경우 알림을 받으려면 '쿼리 실행 지연' 경고를 사용하십시오.
예약된 쿼리 실행에 대해 경고를 구독할 때 사용 가능한 경고 중 하나는 쿼리 실행 지연입니다. 이 경고를 사용하려면 실행하는 데 소요된 시간에 대한 임계값을 설정해야 하며, 이 시점에서 처리 지연에 대한 알림을 받게 됩니다.
알림을 트리거하는 임계값 기간을 선택하려면 텍스트 입력 필드에 숫자를 입력하거나 위쪽 및 아래쪽 화살표를 사용하여 1분 단위로 증가시킵니다. 임계값이 분 단위로 설정되므로 쿼리 실행 지연을 관찰하는 최대 기간은 1440분(24시간)입니다. 실행 지연의 기본 시간은 150분입니다.
노트
경고 구독쿼리 실행 지연을(를) 구독하는 방법에 대해 알아보려면 경고 구독 섹션을 참조하세요.
쿼리 필터링
실행 빈도에 따라 쿼리를 필터링할 수 있습니다. 예약된 쿼리 탭에서 필터 아이콘(
실행 빈도에 따라 쿼리 목록을 필터링하려면 예약됨 또는 한 번 실행 필터 확인란을 선택하십시오.
노트
필터 조건을 활성화했으면 필터 숨기기 를 선택하여 필터 패널을 닫습니다.
쿼리 실행 일정 세부 정보
예약 세부 정보 페이지를 열려면 예약된 쿼리 탭에서 쿼리 이름을 선택합니다. 이 보기는 예약된 쿼리의 일부로 실행된 모든 실행의 목록을 제공합니다. 제공되는 정보에는 시작 및 종료 시간, 상태 및 사용된 데이터 세트가 포함됩니다.
이 정보는 5열 표로 제공됩니다. 각 행은 쿼리 실행을 나타냅니다.
| 열 이름 | 설명 |
|---|---|
| 쿼리 실행 ID | 일별 실행에 대한 쿼리 실행 ID입니다. 쿼리 실행 ID 를 선택하여 쿼리 실행 개요 (으)로 이동합니다. |
| 쿼리 실행 시작 | 쿼리가 실행된 타임스탬프. 타임스탬프는 UTC 형식입니다. |
| 쿼리 실행 완료 | 쿼리가 완료된 타임스탬프. 타임스탬프는 UTC 형식입니다. |
| 상태 | 가장 최근 쿼리 실행의 상태입니다. 상태 값은 Success, Failed, In progress 또는 Quarantined입니다. |
| 데이터 집합 | 실행과 관련된 데이터 세트입니다. |
예약되는 쿼리에 대한 세부 정보는 속성 패널에서 볼 수 있습니다. 이 패널에는 초기 쿼리 ID, 클라이언트 유형, 템플릿 이름, 쿼리 SQL 및 일정의 케이던스가 포함됩니다.
쿼리 실행 ID를 선택하여 실행 세부 정보 페이지로 이동하고 쿼리 정보를 확인합니다.
