IRE(식별 및 조정 엔진)

릴리스 버전: Australia

업데이트 날짜 2026년 03월 12일

소요 시간: 14분

IRE는 식별 및 조정의 기본 핵심 구성요소로, 다양한 데이터 소스에서 식별 및 조정 프로세스를 수행할 수 있는 중앙 집중식 프레임워크를 제공합니다. IRE는 CMDB에 데이터를 삽입하기 전에 들어오는 데이터를 처리할 때 식별 규칙, 조정 규칙 및 IRE 데이터 소스 규칙을 사용합니다.

IRE 프로세스는 CMDB에서 데이터 무결성을 유지하는 데 도움이 됩니다.

IRE는 CI를 고유하게 식별하여 중복 CI를 방지합니다.
IRE는 권한 있는 데이터 소스만 CMDB에 쓸 수 있도록 하여 CI 속성을 조정합니다.

ServiceNow® 가로 검색 및 패턴 검색과 같은 서비스 매핑애플리케이션은 API를 사용하여 식별 및 조정 프로세스를 적용합니다. 임포트 세트에서 임포트한 데이터에 IRE 프로세스를 적용할 수도 있습니다. 타사 데이터 소스를 비롯한 다른 데이터 소스를 사용하는 경우 REST 또는 스크립트 가능한 IRE API를 활용하여 식별 및 조정을 수행할 수 있습니다.

추가 정보:

IRE의 일부 기능에 영향을 주는 속성에 대해서는 다음을 참조하십시오 식별 및 조정 속성.
IRE API 사용 정보: IdentificationEngine - 범위 지정을 참조하십시오.
페이로드 문제 디버깅 활성화 및 확인 정보: IRE로 전송된 페이로드를 기록하고 페이로드 문제를 확인하는 방법 [KB0750382]을 참조하십시오.
페이로드 확인, 조정 적용 및 CMDB에 데이터 커밋과 같이 IRE가 IRE의 작동 방식을 보여주는 IRE가 수행하는 단계에 대해서는 다음과 같습니다. [CMDB - IRE] CI를 페이로드로 createOrUpdateCI() [KB0750386]에 전달할 때 CMDB 식별 및 조정 엔진이 작동하는 방식을 참조하십시오.
IRE를 통해 페이로드를 실행하는 방법 정보: [CMDB IRE] 페이로드 [KB0750383]를 사용하여 요청 시 CI 식별을 실행하는 방법을 참조하십시오.

CI 식별

CMDB 식별 프로세스는 식별 규칙을 사용하여 CI를 고유하게 식별합니다. 가능한 경우 페이로드 섹션과 소스 [sys_object_source] 테이블에 sys_object_source_info 제공된 값을 사용하여 source_name CI source_native_key 를 고유하게 식별할 수도 있습니다. 해당 메서드를 사용하여 식별에 성공하면 느린 식별 방법인 식별 규칙에 의존하는 일치 알고리즘을 적용할 필요가 없습니다.

및 가 제공되고 고유 식별에 사용될 수 있는 경우에도 source_namesource_native_key IRE 식별 규칙 사용의 우선순위를 지정하도록 시스템을 구성할 수 있습니다. 시스템 속성을 사용하여 glide.identification_engine.skip_sys_object_source_matching 이 동작을 관리하는 방법에 대한 자세한 내용은 문서를 참조하십시오 식별 및 조정 속성.

IRE 페이로드의 선택적 sys_object_source_info 객체에 고유한 CI 식별자를 제공할 수 있습니다.

{
  "items": [
    {
      "className": "cmdb_ci_win_server",
      "values": {
        "name": "SAMLABVM52"
      },
      "sys_object_source_info": {
            "source_native_key": "16777219",
            "source_name": "SCCM",
            "source_feed": "SCCM Computer Identity",
            "source_recency_timestamp": "2019-08-26 13:00:00"
      }
     }
    ]
  }

식별 프로세스는 CI 의존성 분류 를 기반으로 CI를 고유하게 식별합니다. 예를 들어, 종속 CI인 Tomcat CI를 식별합니다. Tomcat 애플리케이션(종속 클래스)을 실행 중인 Windows Server CI(독립 클래스)라고 가정합니다. Tomcat 애플리케이션이 동일한 경로의 여러 컴퓨터에서 실행될 수 있으므로 '구성 파일 경로'에 의존하여 Tomcat CI를 고유하게 식별하는 것만으로는 충분하지 않습니다. 식별 엔진은 업데이트할 CI를 선택할 수 없습니다. 종속 관계로 인해 식별 프로세스는 먼저 Tomcat 애플리케이션이 실행 중인 Windows Server 호스트를 식별한 다음 호스트 컨텍스트에서만 Tomcat 애플리케이션 자체를 고유하게 식별해야 합니다.

페이로드 항목 식별

IRE는 수신 페이로드의 모든 페이로드 항목에 대한 식별자 키를 생성한 다음 부분 페이로드와 수신 페이로드를 일치시키려고 할 때 해당 키를 사용합니다. 식별자 키는 다음 중 하나를 기반으로 합니다.

객체의 및 source_namesource_native_key 값의 조합입니다.sys_object_source_info
식별 기준 속성입니다.

IRE는 CMDB IRE Partial Payloads Index [cmdb_ire_partial_payloads_index] 테이블에 부분 항목과 연결된 식별자 키를 저장한 다음, 해당 키를 사용하여 수신 페이로드의 식별자 키와 일치시키려고 합니다.

주요 속성의 타임스탬프

상충하는 속성 값을 해결하기 위해 IRE는 다음 속성의 타임스탬프를 사용하여 현재 기록보다 오래되었으므로 무시할 수 있는 기록을 식별합니다.

최근 디스커버리(last_discovered) 및 디스커버리 소스(discovery_source):

최근 검색(last_discovered)은 CI가 마지막으로 검색된 시점의 타임스탬프입니다. IRE는 다른 CI 속성이 업데이트되지 않아도 페이로드 처리 중에 항상 CI last_discovered 와 discovery_source 속성을 업데이트합니다. 페이로드에 제공된 경우 last_discovered IRE는 페이로드의 시간이 CMDB의 시간보다 최신인 경우에만 last_discovered 제공된 값으로 CI를 업데이트합니다. 페이로드에 제공되지 않은 경우 last_discovered IRE는 현재 타임스탬프로 속성을 업데이트 last_discovered 합니다.

glide.identification_engine.skip_updating_source_last_discovered_if_older 및 glide.identification_engine.ire_message_listener_skip_updating_source_last_discovered_to_now 시스템 속성을 사용하여 이 기본 동작을 수정할 수 있습니다.
처음 검색됨(first_discovered)은 CI가 처음 작성된 시점의 타임스탬프입니다.
- CI가 처음 생성될 때: 페이로드에 값이 제공되면 IRE가 해당 값을 삽입합니다. 그렇지 않으면 IRE는 현재 타임스탬프를 삽입합니다.
- 후속 업데이트에서: 값이 제공되면 IRE는 제공된 값으로 CI를 업데이트합니다. 그렇지 않으면 속성이 업데이트되지 않습니다.

다음 시스템 속성을 사용하여 IRE가 페이로드의 값을 사용하여 source_recency_timestamp 소스 [sys_object_source] 테이블의 속성을 업데이트 last_scan 하는 방법을 수정할 수도 있습니다.

향상된 IRE 기능

CreateOrUpdateCIEnhanced() 및 identifyCIEnhanced 스크립트 가능한 API는 필요에 따라 활성화하거나 비활성화할 수 있는 다음과 같은 향상된 IRE 기능에 대한 기능을 제공합니다.

부분 페이로드

IRE는 데이터 소스가 CI를 고유하게 식별하기에 충분한 정보를 제공하지 않아 처리를 계속할 수 없는 항목을 격리합니다. 이러한 항목 중 일부는 부분 항목으로 식별되며, 나중에 처리할 수 있도록 저장됩니다. 다른 항목은 불완전한 항목으로 식별되며, 이러한 항목은 로깅 목적으로만 저장됩니다.

예: SCCM에는 디스크 피드 및 컴퓨터 피드와 같은 여러 피드가 있습니다. 디스크 피드에 디스크에 대한 전체 정보가 있지만 종속된 컴퓨터 CI에 대한 정보가 충분하지 않을 수 있습니다.

API 옵션: partial_payloads 기본적으로 사용하도록 설정됩니다. 활성화되면 partial_payloadspartial_commitsdeduplicate_payloads 옵션의 설정에 관계없이 자동으로 활성화됩니다.

부분 커밋

일부 항목의 오류는 페이로드의 나머지 항목을 커밋하는 것을 방해하지 않습니다. 따라서 페이로드에 오류가 있는 항목이 포함되어 있어도 IRE는 여전히 페이로드의 나머지 유효한 항목을 커밋합니다. 이 상황에서 커밋되지 않은 항목 중 일부는 부분 페이로드로 저장되고 커밋되지 않은 다른 항목은 미완료 페이로드로 저장됩니다.

API 옵션: partial_commits 기본적으로 사용하도록 설정됩니다.

페이로드 항목 중복 제거

IRE는 페이로드 내에서 중복 항목을 제거하고, 해당 중복 항목을 처리할 단일 페이로드 항목으로 병합합니다.

API 옵션: deduplicate_payloads 기본적으로 사용하도록 설정됩니다.

요약 생성

IRE는 클래스당 업데이트 수와 같은 처리 상세 정보와 함께 출력 페이로드에 요약을 생성합니다.

API 옵션: generate_summary 기본적으로 비활성화되어 있습니다.

부분 항목

페이로드 항목은 고유 식별에 필요한 데이터를 포함하지 않으며 다음 오류 중 하나가 있는 경우 부분 항목으로 결정됩니다. 고유 ID를 사용하려면 sys_object_source_info 페이로드 항목에 및 source_native_key 값이 포함된 source_name 섹션이나 CI 클래스에 지정된 전체 식별 기준 속성 세트 또는 둘 다 있어야 합니다.

부분 항목에 대한 IRE 오류:

MISSING_MATCHING_ATTRIBUTES – 항목에 일치에 하나 이상의 식별자 항목을 사용할 식별 기준 속성이 없습니다.
REQUIRED_ATTRIBUTE_EMPTY –— 필수 속성이 누락되어 CI를 생성할 수 없습니다.
MISSING_DEPENDENCY –— 종속 CI에 페이로드에 지정된 의존성 관계가 없습니다.
INSERT_NOT_ALLOWED_FOR_SOURCE - IRE 데이터 소스 규칙으로 인해 지정된 데이터 소스가 지정된 클래스의 CI를 만들지 못하게 됩니다.

IRE 오류 메시지에 대한 자세한 내용은 다음 문서를 참조하십시오 IRE 오류 메시지.

페이로드 항목이 부분 항목으로 확인되어 처리에 실패하면 부분 항목은 나중에 잠재적으로 처리할 수 있도록 JSON 형식으로 CMDB IRE Partial Payloads [cmdb_ire_partial_payloads] 테이블에 부분 페이로드로 저장됩니다. IRE는 식별자 키를 사용하여 수신 페이로드를 저장된 부분 페이로드와 일치시키려고 시도합니다.

나중에 데이터 소스에서 부분 항목에 누락된 데이터를 전송하는 경우 IRE는 수신 페이로드를 저장된 부분 페이로드와 일치시킵니다. 그런 다음 IRE는 일치하는 부분 페이로드를 수신 페이로드와 병합합니다. 상충하는 속성을 해결하기 위해 IRE는 클래스에 지정된 (source_native_keyWhen and source_name are same) 또는 정적 조정 규칙을 사용합니다 source_recency_timestamp . 그 결과 IRE가 해당 CI를 생성하거나 업데이트하기 위해 처리하는 완전하고 유효한 페이로드가 생성됩니다.

90일이 지난 부분 페이로드는 CMDB IRE 부분 페이로드 [cmdb_ire_partial_payloads] 테이블에서 삭제됩니다.

부분 페이로드 샘플:

Disk feed:
{
  "items": [
    {
      "className": "cmdb_ci_computer",
      "sys_object_source_info": {
            "source_native_key": "Server001",
            "source_name": "SCCM",
            "source_feed": "DISK_FEED",
            "source_recency_timestamp": "2019-08-26 13:00:00"
      }
    },
    {
      "className": "cmdb_ci_disk",
      "values": {
        "name": "disk1"
      }
    }
  ],
  "relations": [{
              "parent": 0,
              "child": 1,
              "type": "Contains::Contained by"}
              ]
}

위 페이로드의 컴퓨터 항목에는 속성이 없으므로 IRE에서 처리할 수 없습니다. 그러나 source_namesource_native_key 제공되어 부분 항목이 됩니다. 컴퓨터 항목이 부분이므로 컴퓨터 항목에 종속된 디스크 항목도 부분 항목입니다.

누락된 상세 정보를 제공하여 이전 부분 페이로드를 완료하는 후속 페이로드의 샘플:

Server/Computer feed:
 {
  "items": [
    {
      "className": "cmdb_ci_linux_server",
      "values": { "name": 'linux001',
                "ip_address": "100.126.38.19",
                "mac_address": "DSWER4587" },
      "sys_object_source_info": {
            "source_native_key": "Server001",
            "source_name": "SCCM",
            "source_feed": "COMPUTER_IDENTITY",
            "source_recency_timestamp": "2019-08-26 14:00:00"
      }
    }
  ]
}

부분 페이로드의 컴퓨터와 새 페이로드의 서버는 동일source_native_key하고 일치하기 때문에 일치합니다.source_name 따라서 부분 페이로드와 새 페이로드가 병합되고, 작업이 커밋되며, 부분 페이로드가 부분 페이로드 테이블에서 삭제됩니다.

부분 페이로드당 항목 수에 대한 제한이 있으며 glide.identification_engine.partial_payload_items_max_size 속성(기본값은 1,000)에 의해 설정됩니다. 연결된 관계, 참조 및 종속 항목을 하나의 부분 페이로드에 저장하면 해당 제한에 도달할 수 있으며, 이 경우 페이로드가 여러 부분 페이로드로 분할됩니다.

부분 페이로드에 대한 자세한 내용은 CreateOrUpdateCIEnhanced()를 참조하세요.

불완전한 항목

다음과 같은 경우 페이로드 항목이 불완전한 항목으로 결정됩니다.

고유 식별에 필요한 모든 데이터가 포함되어 있지는 않습니다.
부분 항목과 관련되지 않은 오류가 있습니다.

객체 내에서 sys_object_source_info 또는 source_native_key CI 클래스에 지정된 전체 식별 기준 속성 세트가 제공되지 않으면 고유 식별이 불가능합니다source_name.

불완전한 항목은 CMDB IRE 불완전한 페이로드 [cmdb_ire_incomplete_payloads] 테이블에 JSON 형식으로 불완전한 페이로드로 저장됩니다. 불완전한 항목은 복구할 수 없는 오류가 있는 페이로드를 로깅하기 위해 저장되며 다시 처리되지 않습니다.

관계 추가

인덱스 또는 선택적 JSON internal_id 요소를 사용하여 관계를 추가합니다.

페이로드의 객체를 사용하여 relations 항목을 참조 internal_ids 하여 관계를 추가하거나 업데이트합니다. 페이로드의 메인 항목과 관련 항목을 사용하여 관계를 만들 수 있습니다. 예:

관계(상위 인덱스, 하위 인덱스, 관계 유형)
관계(상위 내부 ID, 하위 내부 ID, 관계 유형)

자세한 내용 및 코드 샘플은 CreateOrUpdateCIEnhanced()를 참조하십시오.

페이로드 항목 간에 참조 추가

페이로드 항목을 고유하게 식별하는 선택적 JSON internal_id 요소를 사용하여 두 페이로드 항목 간에 참조를 추가합니다.

블록을 referenceItems 사용하여 참조를 추가하거나 업데이트합니다. 메인 항목, 조회 항목 및 관련 항목을 포함하여 단일 페이로드에 두 항목 간에 참조를 추가할 수 있습니다.

자세한 내용 및 코드 샘플은 CreateOrUpdateCIEnhanced()를 참조하십시오.

CI 재분류

페이로드의 설정 블록에서 , updateWithoutDowngrade및 updateWithoutSwitch 플래그를 사용하여 updateWithoutUpgradeCI의 클래스가 의도하지 않게 업데이트되는 것을 방지합니다. 이러한 플래그는 동일한 CI를 업데이트하는 동안 여러 데이터 소스가 의도치 않게 시도할 수 있는 CI의 클래스를 업그레이드, 다운그레이드 또는 전환하는 것을 방지합니다. 자세한 내용 및 코드 샘플은 CreateOrUpdateCIEnhanced()를 참조하십시오.

재분류 플래그는 에 대한 다른 시스템 설정보다 우선합니다.IRE 처리 중 CI 재분류 구성

사용자 지정 전후 스크립트 추가

통합 허브 ETL을 사용하여 CMDB 통합 애플리케이션의 데이터 소스에 대한 사용자 지정 Java 스크립트를 추가합니다. 이러한 스크립트는 CMDB 통합을 처리하는 동안 IRE 입력 및 출력 페이로드에 대한 액세스를 제공합니다.

이전 스크립트는 IRE로 전송될 입력 페이로드 배치에 대한 액세스를 제공합니다. 사용자 지정 before 스크립트를 사용하면 다음을 수행할 수 있습니다.

건너뜀으로 설정 status 하여 배치에서 페이로드를 건너뜁니다. 선택적으로, 해당 임포트 세트 행 테이블에 설명으로 표시될 페이로드를 건너뛰는 이유를 제공합니다.
입력 페이로드를 수정합니다.
IRE 페이로드를 사용하는 스크립트 내에 다른 사용자 지정 논리를 작성합니다.

스크립트 이후 IRE 입력 및 출력 페이로드에 대한 액세스를 제공합니다. 사용자 지정 after 스크립트를 사용하면 다음을 수행할 수 있습니다.

입력 및 출력 페이로드를 쉽게 비교하고 IRE가 각 CI에서 수행한 다양한 작업을 식별합니다.
IRE가 만들거나 업데이트한 CI sys_ids에 액세스합니다.
IRE 출력 페이로드를 사용하는 스크립트 내에 다른 사용자 지정 논리를 작성합니다.