MID 서버 ECC 큐

릴리스 버전: Washingtondc

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

읽기6분

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

비동기 메시지 버스

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

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

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

주:

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

ECC 큐 정보

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

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

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


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

ECC 큐 제어

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


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

MID Server의 ECC 큐 컨텐츠 관리

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

시작하기 전에

필요한 역할: admin mid_server

프로시저

를 실행 검색하지 않고 MID Server를 통해 ECC 큐에서 직접 호스팅 장치로 원격 명령을 보냅니다.
1. ECC 대기열로 이동하여 새로 만들기를 클릭합니다.
2. 다음 설정으로 메시지를 만듭니다.
  - 에이전트: 명령을 실행하는 MID Server의 이름입니다.
  - 주제: 명령
  - 이름: 처리하려는 실제 명령입니다. Windows의 경우 DOS 명령줄 구조로 표현됩니다. Linux의 경우 구조는 bash 명령줄 항목일 수 있습니다.
  - 큐: 출력
  - 페이로드: 적절한 XML 태그를 사용하면 이름 필드 대신 여기에서 명령을 지정할 수 있습니다. 이 방법의 장점은 명령이 120자의 이름 필드 길이로 제한되지 않는다는 것입니다. 명령에 다음 XML 형식을 사용합니다.
```
<parameters>
   <parameter name="name" value="ACTUAL_COMMAND_LINE"/>
</parameters>
```
개별 MID Server에 대한 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 서버]