@servicenow-<INSTANCE_NAME>을 사용하여 레거시 모니터링 알림을 구성하려면 다음 단계를 따르세요.

1. Datadog에서 ServiceNow 통합 설정 페이지로 이동합니다.

2. Configure 탭으로 이동한 다음 ITOM/ITSM 탭, Monitors 탭으로 이동합니다.

3. Manage Legacy Monitor Notifications에서 알림을 설정하려는 인스턴스를 선택한 다음 레거시 모니터링 알림에 쓸 표를 선택합니다.

4. 통합이 올바르게 설정되었는지 확인하기 위해 모니터 또는 이벤트 알림에 @servicenow-<INSTANCE_NAME>을 추가합니다. ServiceNow가 인시던트 우선순위를 계산하는 데 사용할 수 있도록 Impact 및 Urgency 값을 모두 정의할 수 있습니다. 원시 데이터는 중간 표의 행을 채우고 통합에 의해 지정된 ServiceNow 표로 전달됩니다.

5. ServiceNow에서 변환 맵을 사용하여 중간 테이블로 전송되는 데이터의 변환을 사용자 지정합니다.

6. 사용 가능한 Datadog 변수 또는 커스텀 문자열을 사용하여 알림 페이로드를 사용자 지정합니다.

참고: 모니터 설명의 Impact 및 Urgency는 레거시 모니터 구성에서만 작동합니다. 서식화된 모니터의 경우 인스턴스 우선순위 매핑을 구성합니다. ServiceNow 인시던트의 priority 필드는 읽기 전용이며 우선 순위 조회 규칙을 통해서만 업데이트할 수 있습니다.

action

유형: 문자열
모니터링에서 수행되는 작업: create, update, acknowledge 또는 resolve

additional_information

유형: 문자열
ITOM 변환: additional_info
모든 이벤트 세부 정보가 포함된 형식화된 문자열

aggreg_key

유형: 문자열
경고 모니터의 ID 해시를 나타내는 집계 키

alert_cycle_key

유형: 문자열
단일 모니터의 경고 주기(경고 → 주의 → 해결)의 해시를 나타내는 키입니다.

alert_id

유형: 문자열
경고 모니터의 ID입니다.

alert_metric

유형: 문자열
ITOM 변환: metric_name
경보를 트리거한 메트릭입니다.

alert_query

유형: 문자열
경보를 트리거한 쿼리입니다.

alert_scope

유형: 문자열
경보를 트리거한 범위

alert_status

유형: 문자열
현재 경보 상태

alert_title

유형: 문자열
경보 이름

alert_transition

유형: 문자열
ITSM 변환: (스크립트) -> 상태
경고 전환 상태: Triggered, Warn 또는 Recovered

assignment_group_sys_id

유형: 참조
ITSM 변환: assignment_group
Reference Table: 그룹
템플릿 핸들의 할당 그룹에 대한 ServiceNow sys_id

business_service_sys_id

유형: 참조
ITSM 변환: business_service
Reference Table: 서비스
템플릿 핸들의 비즈니스 서비스에 대한 ServiceNow sys_id

custom_fields

유형: 문자열
JSON 변환 가능한 문자열로 형식이 지정된 사용자 설정 키-값 필드

datadog_tags

유형: 문자열
알림 모니터의 Datadog 태그

description

유형: 문자열
ITSM 변환: description
ITOM 변환: description
모니터 알림에 대한 요약 설명

event_details

유형: 문자열
ITSM 변환: work_notes
연결되는 형식이 지정되어 있고, 클릭 가능한 Datadog 링크가 포함된 이벤트 세부 정보

event_id

유형: 문자열
이벤트의 Datadog ID

event_link

유형: 문자열
모니터 알림에서 생성된 이벤트 링크

event_msg

유형: 문자열
이벤트 메시지

event_title

유형: 문자열
ITSM 변환: short_description
이벤트 타이틀

event_type

유형: 문자열
ITOM 변환: type
이벤트 유형

hostname

유형: 문자열
ITSM 변환: cmdb_ci
ITOM 변환: node
영향을 받는 모니터의 호스트

impact

유형: 정수
ITSM 변환: impact
모니터 우선순위의 사용자 정의 매핑을 기반으로 한 영향 값

logs_sample

유형: 문자열
관련 로그 샘플

monitor_priority

유형: 정수
ITOM 변환: severity
정수로 표시된 알림 모니터의 우선순위

org_name

유형: 문자열
알림 모니터의 조직 이름

sys_created_by

유형: 문자열
ITSM 변환: caller_id
레코드 작성자(일반적으로 구성된 ServiceNow API 계정)

ticket_state

유형: 문자열
ITSM 변환: state, (스크립트) -> close_code, (스크립트) -> close_notes
ITOM 변환: (스크립트) -> resolution_notes
ServiceNow 레코드 상태: new 또는 resolved

u_correlation_id

유형: 문자열
ITSM 변환: correlation_id
ITOM 변환: message_key
레코드를 동일한 대상 인시던트로 병합하는 데 사용되는 결합된 alert_cycle_key 및 aggreg_key

urgency

유형: 정수
ITSM 변환: urgency
모니터 정의 우선순위에 따라 통합 타일의 사용자 정의 매핑에서 설정된 긴급도

user_sys_id

유형: 참조
ITSM 변환: assigned_to
Reference Table: 사용자
사용자에 대해 전달된 템플릿 핸들에서 가져온 sys_id

가져오기 세트 표 x_datad_datadog_import_host에 너무 많은 행이 쌓이는 것을 방지하기 위해, 최근 24시간 데이터만 유지하도록 표 정리 도구에 자동 플러시 규칙이 추가되었습니다. 이 구성 설정은 필터 탐색기에서 sys_auto_flush_list.do로 이동하여 x_datad_datadog_import_host 표에 대한 규칙으로 들어가 필요에 따라 변경할 수 있습니다. 그에 따라 Age in seconds 필드를 업데이트할 수 있습니다.

ServiceNow에서 사용자 지정 필드 매핑을 만드는 방법:

1. 테이블 중 하나를 클릭하고(예: Datadog ITSM 테이블 모니터링) 레코드 하단으로 스크롤하여 연결된 변환 맵의 링크를 확인합니다.

2. 변환 맵의 이름을 클릭하면 레코드를 볼 수 있습니다.

   상단에는 변환 레코드의 두 가지 중요한 필드인 Source table 및 Target table이(가) 있습니다.

3. New를 클릭합니다.

4. 일대일 매핑을 위해 소스 필드와 대상 필드를 선택합니다.

   또는 Use source script 상자를 검사하고 변환을 정의합니다.

통합 타일에서 사용자 지정 필드를 매핑하려면 Datadog 모니터 ITOM 및 Datadog 모니터 ITSM 변환 맵 모두에 대해 다음 스크립트를 사용할 수 있습니다. 이 예시에서 my_field 필드는 통합 타일에서 사용자 지정 필드로 정의됩니다.

answer = (function transformEntry(source)
{
    var additional_info = JSON.parse(source.additional_info);
    return additional_info.my_field;
})(source);

참고:

• 소스는 선택한 가져오기 집합 표(이 경우, Datadog ITSM 표 모니터링)이고 대상은 이벤트가 저장되어 있는 실제 인시던트 표(또는 이벤트 표)입니다.

• 필드 매핑은 레코드 하단에 있습니다. 여기에는 일부 기본 매핑이 포함되어 있습니다. 여기에서 포함할 필드를 선택하고, 형식을 정의하며, ServiceNow 인스턴스에서 대상 필드를 선택합니다.

상관관계가 있는 경보의 정보를 사용하여 ServiceNow의 값을 채우려면 Datadog 케이스 ITSM/ITOM 표 변환 맵 아래에 새 onBefore 변환 스크립트를 추가하세요.

ServiceNow 인시던트에 데이터를 채우려면 Datadog에서 전송되어 EM 상관관계 경보 열에 저장된 데이터를 구문 분석하도록 스크립트를 수정하고, 구문 분석된 데이터를 보낼 인시던트의 필드를 지정해야 합니다. 다음은 필요에 따라 사용자 지정할 수 있는 샘플 스크립트입니다.

(function runTransformScript(source, map, log, target /*undefined onStart*/ ) {
    // We do not need to process non-correlated-alert events
    if (!source.em_correlated_alert_id) {
        return;
    }

    // Create a GlideRecord for the table
    var gr = new GlideRecord('x_datad_datadog_case_incident_table');
    gr.addQuery('case_id', source.case_id);
    gr.addNotNullQuery('em_correlated_alert_id');
    gr.orderByDesc('sys_created_on');
    gr.query();

    // Ensure we process each alert_id only once
    var seenAlert = {};

    // Add relevant correlated alert fields here
    var alertNames = [];


    // Loop through list of correlated_alerts associated with the same case_id
    while (gr.next()) {
        var emAlertId = gr.getValue('em_correlated_alert_id');

        if (!seenAlert.hasOwnProperty(emAlertId)) {
            seenAlert[emAlertId] = true;
            var changeType = gr.getValue('em_change_type');
            if (changeType == "added") {
                var correlatedAlert = gr.getValue("em_correlated_alert");
                var jsonAlert = JSON.parse(correlatedAlert);

                // Get relevant fields from the JSON event
                var alertName = jsonAlert['alert_message'];
                alertNames.push(alertName);
            }
        }
    }

    // Set the corresponding value on the incident table
    // target.impact = 1;

})(source, map, log, target);

Datadog 통합 타일에서 오류 메시지가 표시되거나 Error while trying to post to your ServiceNow instance 알림이 나타나는 경우:

• 인스턴스 이름을 입력할 때 하위 도메인만 사용되었는지 확인합니다.

• 생성한 사용자에게 필요한 권한이 있는지 확인합니다.

• 사용자 이름과 비밀번호가 올바른지 확인합니다.

통합이 설정되고 경보가 트리거되었지만 티켓이 생성되지 않은 경우:

• 임시 표가 채워져 있는지 확인합니다. 그럴 경우 문제는 매핑 및 변환에 있는 것입니다. ServiceNow에서 Transform Errors로 이동하여 매핑 및 스크립트를 추가로 디버깅할 수 있습니다.
• 타일에서 지정한 임시 표로 작업하고 있는지 확인합니다.

ServiceNow 사용자는 가져오기 표에 액세스할 수 있도록 rest_service 및 x_datad_datadog.user 역할이 필요합니다. 알림을 인시던트 표나 이벤트 표로 직접 보내는 기존 방식을 사용하는 경우 itil 및 evt_mgmt_integration 권한이 필요합니다.

Datadog Work Management에서 ServiceNow로의 업데이트는 확인되지만 ServiceNow에서 Datadog으로의 업데이트가 확인되지 않는 경우, 이는 ServiceNow ITOM에 대해 예상되는 동작입니다. Work Management와의 양방향 동기화는 ServiceNow ITSM에서만 지원됩니다.

모니터가 각 경고에 대해 새 인시던트를 생성하는 대신 동일한 인시던트를 다시 여는 경우, 단순 경고로 설정되어 있지 않은지 확인하세요. 메트릭의 태그를 사용하여 그룹화함으로써 모니터를 복수 경고로 변환하세요. 이렇게 하면 각 경고가 별도의 인시던트를 트리거합니다.