MID Hermes API 확장
MID Hermes API는 MID 서버 를 통한 MID 서버통신 Hermes 을 가능하게 하는 확장입니다.
MID 스크립트 포함 및 MID Hermes 생산자 API를 사용하여 주제에 Hermes 메시지 페이로드를 보냅니다. MID 스크립트에는 스크립트 가능한 API 인터페이스를 스트리밍 연결 통해 데이터를 Hermes 밀어넣으므로 필요하지 않습니다. 이 확장을 사용하려면 MID Hermes API(com.glide.mid.hermes_api) 플러그인을 ServiceNow 활성화하십시오.
확장 컨텍스트 기록
- 확장 컨텍스트의 상태를 봅니다.
- 확장 컨텍스트를 시작, 중지 및 다시 시작합니다.
- 매개변수를 업데이트합니다.
- 허용된 Hermes 주제를 보고 주제를 편집하거나 생성합니다.
통계
다음으로 이동하여 MID Hermes API 확장에 대한 통계를 볼 수 있습니다. 또는 MID Hermes API 통계 [sys_mid_hermes_api_metric] 테이블로 직접 이동합니다.
- 바이트 수: 수집 간격 동안 생성된 바이트 수입니다.
- 수집 시간: 수집 간격이 종료된 시간입니다.
- 수집 간격(초): 수집 간격의 기간입니다. 기본값은 60초입니다.
- 메시지 수: 수집 간격 동안 생성된 메시지 수입니다.
- MID Hermes API 확장 컨텍스트: 메시지 작성에 사용되는 확장 컨텍스트 기록의 이름입니다.
- MID 서버: 확장 컨텍스트 실행에 대한 MID 서버 참조입니다.
- 주제: 확장 컨텍스트가 메시지를 생성하는 주제의 이름 Hermes 입니다.
이 테이블의 메트릭은 (extension_context, 주제)당 메모리 내에서 수집되고 각 60초 간격 동안 지속적으로 집계됩니다. 그런 다음 단일 배치 ServiceNow로 전송되어 각 메시지에 대한 개별 기록이 아닌 간격당 고유한 컨텍스트-주제 조합당 하나의 데이터베이스 기록이 생성됩니다.
이 테이블에는 데이터 보존 정책에 따라 오래된 통계 기록을 자동으로 제거하는 테이블 클리너가 있어 테이블이 무제한으로 증가하는 것을 방지하는 데 도움이 됩니다.
인증서 액세스
mTLS Hermes 액세스 인증서에는 주제 ACL이 포함되어 있습니다. CSR MID 서버 을 생성할 때 MID 확장 컨텍스트 테이블의 topics_acl 필드 값이 CSR의 ACL로 설정됩니다. CSR에 서명하기 위한 REST 호출이 MID 확장 컨텍스트 sys_id를 전달하므로 서버는 ACL이 컨텍스트 구성과 일치하는지 확인할 수 있습니다.
액세스 인증서의 Hermes ACL이 MID 확장 컨텍스트 기록 MID 서버 의 ACL과 일치하지 않으면 최대 3회까지 자동으로 검증을 재시도합니다. 각 시도 MID 서버 사이에 인스턴스에서 최신 ACL을 다시 가져옵니다. 최종 시도 후에도 ACL이 일치하지 않으면 REST 오류가 반환되고 로깅됩니다.
MID 확장 컨텍스트가 시작되면 이 컨텍스트에서 제공하는 주제 ACL 문자열이 mTLS Hermes 액세스 인증서의 일부인 문자열과 비교됩니다. 다른 경우 올바른 ACL이 있는 새 mTLS 인증서가 생성됩니다.
허용된 주제가 변경되면 비즈니스 규칙이 자동으로 MID 확장 컨텍스트를 다시 시작합니다. 확장이 다시 시작될 때 새 구성이 로드될 때까지 이전 구성으로 계속 생산이 작동합니다.
인증서는 7일 동안 유효합니다. 인증서가 생성되면 5일 타이머가 액세스 인증서가 만료되기 전에 액세스 인증서를 다시 요청하기 시작합니다.
MID Hermes API 확장 구성
MID Hermes 생산자 API가 를 통해 MID 서버메시지를 Hermes 작성할 수 있도록 MID Hermes API 확장을 구성합니다.
시작하기 전에
- 필요한 역할: kafka_admin
- 를 배포하고 시작합니다.MID 서버
- MID Hermes API(com.glide.mid.hermes_api) 플러그인을 ServiceNow 활성화합니다.