Grafana 이벤트 통합

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 소요 시간: 4분

    • Grafana 콘솔에서 표준 웹후크를 추가하여 Grafana와 이벤트 관리를 통합합니다.

    시작하기 전에

    • 이벤트 관리 커넥터(sn_em_connector) 플러그인이 Now Platform 인스턴스에 설치되어 있는지 확인합니다.
    • Now Platform 인스턴스에 이벤트 관리 플러그인을 설치해야 합니다.
    • CI 바인딩은 IP를 통해 이루어지며, 바인딩을 시작하려면 인스턴스를 서버로 검색해야 합니다. cmdb_ci_vm_object 내의 클라우드 또는 CI를 통해 검색된 CI는 바인딩되지 않으며, 이는 Grafana가 객체 ID에 대한 정보를 제공하지 않기 때문입니다.
    • 필요한 역할: evt_mgmt_integration

    이 태스크 정보

    Grafana에서의 이벤트 수집을 위해 이벤트 관리 환경을 구성합니다. Grafana 콘솔에서 표준 웹후크를 사용하여 Now Platform 인스턴스를 REST 엔드포인트로 설정합니다.

    주:
    Grafana v7.4.3에 대해 1단계와 2단계를 수행합니다. Grafana v9.3.2의 경우 3단계로 건너뜁니다.

    프로시저

    Grafana v7.4.3
    1. Grafana 콘솔에서 알림 채널을 생성합니다.
      1. 다음으로 이동 경고 > 알림 채널.
      2. 새 채널을 클릭하여 유형을 웹후크로 선택합니다.
      3. URL을 입력합니다.
        예를 들면 https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=grafana입니다.
      4. 선택적 웹후크 설정에서 HTTP 메서드, POST를 선택하고 관련 ServiceNow 사용자의 사용자 이름과 암호를 입력합니다.
        주:
        선택한 사용자에게 evt_mgmt_integration 역할이 할당되어 있는지 확인합니다. 적절한 인증을 보장하기 위해 높은 권한의 사용자 대신 evt_mgmt_integration 역할을 보유한 최소 권한의 사용자를 사용합니다.
      5. 테스트를 클릭하여 연결을 검증합니다.
    2. Grafana 콘솔에서 경보 규칙을 생성합니다.
      1. 필수 패널에서 편집을 클릭한 다음 경보를 생성합니다.
      2. 경보 탭에서 다음 태그를 추가합니다.
        태그 설명
        심각도 (이 태그는 선택 사항이며 소문자로 구성되어야 합니다.) 경보를 생성해야 하는 심각도입니다.
        개수 (이 태그는 필수이며 이 태그가 없으면 ServiceNow에서 경보가 자동으로 종결되지 않습니다.) 이 경보 규칙에 의해 모니터링되는 장치, 호스트 또는 서버의 수입니다.
      3. 경보 규칙의 알림에서 알림 채널을 추가합니다.
      4. 저장을 클릭합니다.
      5. 다음으로 이동 경고 > 경보 규칙 생성된 규칙에 액세스합니다.
    Grafana v9.3.2.
    1. Grafana 콘솔에서 접촉 창구 지점을 생성합니다.
      1. 다음으로 이동 경고 > 연락처 거점.
      2. 새 접촉 창구 지점을 클릭하고 이름을 입력한 다음 유형을 웹후크로 선택합니다.
      3. URL을 입력합니다.
        예를 들면 https://<instance-name>.service-now.com/api/sn_em_connector/em/inbound_event?source=grafana입니다.
      4. 선택적 웹후크 설정에서 HTTP 메서드, POST를 선택하고 관련 ServiceNow 사용자의 사용자 이름과 암호를 입력합니다.
        주:
        선택한 사용자에게 evt_mgmt_integration 역할이 할당되어 있는지 확인합니다. 적절한 인증을 보장하기 위해 높은 권한의 사용자 대신 evt_mgmt_integration 역할을 보유한 최소 권한의 사용자를 사용합니다.
      5. 저장 및 테스트를 클릭하여 연결을 검증합니다.
    2. Grafana 콘솔에서 알림 정책을 생성합니다.
      1. 다음으로 이동 경고 > 알림 정책.
      2. 새 정책을 선택하고 정합기를 추가합니다.
        정합기는 경보 규칙을 접촉 창구 지점으로 보내는 레이블입니다.
      3. 접촉 창구 지점을 선택합니다.
      4. 정책 저장을 선택합니다.
    3. Grafana 콘솔에서 경보 규칙을 생성합니다.
      1. 다음으로 이동 경고 > 경보 규칙.
      2. 새 규칙을 선택합니다.
      3. 쿼리 및 경보 조건을 설정합니다.
      4. 데이터 소스, 메트릭 및 필요한 필터를 설정합니다.
      5. 경보 평가 동작을 설정합니다.
      6. 규칙 이름을 입력합니다.
      7. 요약 및 주석 섹션에서 요약 또는 설명을 추가합니다.
      8. 아래로 스크롤에서 +새로 추가를 선택합니다.
      9. 노드, 자원 및 메트릭 정보를 입력합니다.
        이 정보는 이벤트의 노드, 자원 및 metric_name 필드에 필요합니다.
        주:
        값 문자열을 사용하여 이러한 값을 전달합니다. 예를 들어 노드는 {{ $values.C0.Labels.instance }}일 수 있습니다.
      10. 사용자 지정 레이블 아래에 알림을 적절한 접촉 창구 지점으로 보내는 데 필요한 레이블을 제공합니다.
        주:
        사용자 지정 레이블 아래에 심각도를 전달할 수도 있습니다. 이벤트에도 동일하게 사용됩니다. 사용 가능한 심각도 옵션은 심각, 중요, 경미, 경고입니다.
      11. 저장을 클릭합니다.

    결과

    Grafana에서 이벤트 관리 플러그인으로 경보 플로우가 시작됩니다. 플러그인은 원본 Grafana 경보 메시지에서 정보를 추출하여 필요한 이벤트 필드를 채우고 이벤트를 데이터베이스에 삽입합니다. Now Platform 인스턴스에서 모든 이벤트로 이동하여 이벤트를 확인합니다.

    주:
    • Grafana v7.4.3의 경우 경보에 바인딩되지 않은 추가 지우기 이벤트가 ServiceNow에 수신되는 것을 볼 수 있습니다. 이러한 이벤트는 Grafana가 알림 지우기에 정보를 보내지 않는 문제를 해결하기 위해 생성된 것이므로 무시하십시오.
    • Grafana 8 이상에만 사용되는 심각도 매개변수가 추가되었습니다. 제공된 값은 심각도가 사용자 지정 레이블에 전달되지 않는 경우 이벤트의 심각도로 사용됩니다.