MID 서버 ECC 큐

릴리스 버전: Xanadu

업데이트 날짜 2024년 08월 01일

읽기6분

ECC(외부 통신 채널) 큐는 인스턴스와 MID Server 간의 연결 지점입니다. MID 서버에서 수행해야 하는 작업은 MID 서버에서 처리할 준비가 될 때까지 이 큐에 저장됩니다.

비동기 메시지 버스

MID Server는 Asynchronous Message Bus(AMB)가 게시한 메시지를 구독하여 MID Server에 ECC 큐에 보류 중인 작업 기록이 있음을 알립니다. 작업이 해당 MID Server의 ECC 큐에 있으면 MID Server는 상태를 "처리 중"으로 설정합니다. 요청된 작업에 대한 작업이 완료되면 MID 서버는 결과를 ECC 큐에 다시 보고합니다.

MID 서버는 AMB 클라이언트를 통해 인스턴스에 대한 영구 연결을 열고 /mid/server/<mid_sys_id> AMB 채널을 수신합니다. 출력 레코드가 큐 [ecc_queue] 테이블에 삽입되면 AMB 메시지가 MID 서버의 채널로 전송됩니다. MID Server가 사용 중이고 메시지 우선순위 수준이 대화형이 아닌 경우, MID Server는 이 메시지를 수신하고 작업을 위해 ecc_queue 테이블을 즉시 폴링합니다.

MID Server는 AMB 메시지 활동에 관계없이 mid.poll.time 구성 매개변수에 정의된 최대 일반 간격(기본적으로 40초)으로 ECC 큐를 폴링합니다. MID가 사용 중이고 대화형 이외의 우선 순위 수준으로 AMB 메시지를 수신하는 경우 큐 폴링 시간이 mid.poll.time.standard (기본적으로 5초)로 변경됩니다. 정기적으로 ECC 대기열의 폴링은 AMB 연결이 끊어진 경우에 수행됩니다.

주:

MID Server의 AMB 클라이언트는 일부 환경에서는 작동하지 않으며 성능 문제를 방지하기 위해 사용하지 않도록 설정해야 할 수 있습니다. 사용자 환경에서 AMB를 사용하지 않도록 설정하려면 mid.disable_amb 매개 변수를 true로 설정합니다. AMB를 사용하지 않도록 설정하면 MID 서버는 더 이상 각각의 새 ECC 큐 출력 레코드에 대한 알림을 수신하지 않습니다. 자세한 내용은 mid.poll.time 을 참조하십시오 MID 서버 매개변수 .

ECC 큐 정보

다음 경로 중 하나를 탐색하여 ECC 큐에 액세스할 수 있습니다.

디스커버리 > 출력 및 아티팩트 > ECC 큐
디스커버리 > 디스커버리 일정 > {일정 이름} > {검색 상태 기록}
ECC > 큐
{검색 상태 기록} > ECC 큐

ECC 큐는 다음 정보를 제공합니다.


필드	입력 값
에이전트	이 메시지의 송신 또는 수신 외부 시스템의 이름입니다. 메시지가 MID Server에서 또는 MID Server로 수신되는 경우 에이전트 이름은 `mid.server.xxx` 형식이며 여기서 xxx는 특정 MID Server의 이름입니다.
주제	MID 서버가 실행한 프로브 이름입니다. 검색에 패턴을 사용하는 경우 수평 패턴 프로브 수평 패턴 프로브 가 나타납니다.
이름	프로브가 실행한 실제 명령입니다. 예를 들어, 주제 가 SSHCommand인 경우 이름 필드에는 실행할 실제 셸 명령이 포함됩니다. 검색에 패턴을 사용하는 경우 다음이 나타납니다. 패턴 시작 관리자: 패턴 이름과 다중 페이지 번호가 뒤따릅니다.
소스	검색을 실행할 IP 주소입니다. 일부 프로브는 여러 IP 주소에 대해 실행됩니다. 이러한 경우 이 필드에는 사람이 읽을 수 있는 설명이 포함됩니다.
응답 대상	이 선택적 필드에는 이 메시지에 응답하는 ECC 큐 메시지에 대한 참조(sys_id)가 들어 있습니다. 검색은 이 필드를 광범위하게 사용하여 지정된 예약된 검색에서 발생하는 메시지의 계층 구조를 추적합니다. 이 필드의 값에 대한 기록 아이콘을 클릭하여 현재 프로브 또는 센서 기록을 생성한 활동에 대한 ECC 큐 기록을 엽니다.
큐	이 메시지가 입력 메시지인지 출력 메시지인지를 나타내는 표시기입니다.
상태	현재 ECC 큐 기록의 상태입니다. 상태는 자동으로 업데이트됩니다.
처리됨	이 메시지가 처리된 시간입니다.
작성됨	이 메시지가 작성된 시간입니다.
시퀀스	이 메시지의 고유 시퀀스 번호입니다. 이 값은 ECC 큐 기록이 삽입될 때 자동으로 생성됩니다. 사용은 더 이상 사용되지 않습니다.
오류 문자열	처리 중에 오류가 발생한 경우 오류 메시지입니다. 이 필드는 오류가 없는 한 표준 양식에서 숨겨집니다.
페이로드	XML 형식의 메시지 본문입니다. 반환된 XML에는 하나 이상의 `<result>` 태그와 단일 `<parameters>` 태그를 포함하는 `<results>` 루트 태그가 있습니다. 매개변수는 프로브의 MID Server로 전송된 매개변수의 에코일 뿐입니다. 프로브마다 다르지만 일반적으로 프로브가 수행할 작업과 작동 방식에 대한 세부 정보를 프로브에 알려줍니다. 결과 태그는 프로브에서 생성된 실제 데이터를 포함한다는 점에서 가장 흥미로운 태그입니다.

ECC 큐 통제

ECC 큐 양식에는 다음과 같은 관련 링크가 포함되어 있습니다.


관련 링크	설명
다시 실행	프로브를 다시 실행합니다. 검색 실패 또는 예기치 않은 결과가 발생하면 프로브를 다시 실행할 수 있습니다.
CMDB 항목으로 이동	검색 중 업데이트된 CI의 CI 기록을 엽니다.
센서로 이동	연결된 센서에 대한 기록을 엽니다.

ECC 큐 재시도 정책

ECC 큐 재시도 정책 및 큐 재시도 활동 모듈을 보려면 다음 플러그인을 활성화해야 합니다.

플러그인 이름: ECC 큐 재시도 정책
ID: com.glideapp.ecc_retry_policy

MID 서버의 ECC 큐 컨텐츠 관리

ECC 큐를 사용하면 ECC 큐 메시지를 생성하고, MID Server 로그 항목에 액세스하고, 개별 MID Server 기록에서 통계를 검색할 수 있습니다.

시작하기 전에

필요한 역할: admin, mid_server

프로시저

를 실행 검색하지 않고 MID 서버를 통해 ECC 큐에서 직접 호스팅 장치로 원격 명령을 보냅니다.
1. ECC 대기열로 이동하여 새로 만들기를 클릭합니다.
2. 다음 설정을 사용하여 메시지를 생성합니다.
  - 에이전트: 명령을 실행하는 MID 서버의 이름입니다.
  - 주제: 명령
  - 이름: 처리하려는 실제 명령입니다. Windows의 경우 DOS 명령줄 구조로 표현됩니다. Linux의 경우 구조는 bash 명령줄 항목일 수 있습니다.
  - 큐: 출력
  - 페이로드: 적절한 XML 태그를 사용하면 이름 필드 대신 여기에 명령을 지정할 수 있습니다. 이 방법의 장점은 명령이 120자의 이름 필드 길이로 제한되지 않는다는 것입니다. 명령에 다음 XML 형식을 사용합니다.
```
<parameters>
   <parameter name="name" value="ACTUAL_COMMAND_LINE"/>
</parameters>
```
개별 MID 서버에 대한 agent0.log.0 로그와 wrapper.log 로그를 표시하는 ECC 큐의 항목에 액세스합니다.
1. MID Server 기록을 엽니다.
2. 관련 링크 아래에서 MID 로그, 파일 및 스레드 덤프 가져오기를 클릭합니다.
  ECC 큐 기록은 다음 필터를 사용하여 목록에 나타납니다.
  - [주제] [이다] [시스템 명령]
  - [출처] [이다] [로그 잡기]
  - [에이전트] [이다] [MID 서버]
  agent0.log.0 및 wrapper.log 항목만 나타납니다. 이러한 로그는 ~\agent\logs\ 파일 경로에서도 액세스할 수 있습니다.
3. 로그 항목을 열려면 생성 됨 열 아래의 링크를 클릭합니다.
메모리 및 CPU 사용량 데이터와 같은 개별 MID Server에 대한 유용한 정보를 보려면 queue.stats 주제에 액세스하십시오.
1. MID Server 기록을 엽니다.
2. 관련 링크 아래에서 MID 통계를 클릭합니다.
  ECC 큐 기록은 다음 필터를 사용하여 목록에 나타납니다.
  - [주제] [이다] [큐.stats]
  - [에이전트] [이다] [MID 서버]