ServiceNow데이터 소스에 연결 - Amazon Managed Grafana

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

ServiceNow데이터 소스에 연결

ServiceNow인스턴스에 연결하는 데 사용되는 ServiceNow 데이터 소스입니다.

참고

이 데이터 소스는 Grafana 엔터프라이즈 전용입니다. 자세한 정보는 엔터프라이즈 플러그인 액세스 관리을 참조하세요.

또한 버전 9 이상을 지원하는 작업 공간에서는 이 데이터 소스를 사용하려면 적절한 플러그인을 설치해야 할 수 있습니다. 자세한 정보는 플러그인으로 작업 영역 확장을 참조하세요.

특성

  • 쿼리

    • 통계 API 쿼리

    • 테이블 API 쿼리

      • 인시던트, 변경 사항 및 기타 테이블

  • 알림

  • 주석 (베타 기능)

  • 템플릿 변수

구성

Grafana 왼쪽 패널에서 데이터 소스를 선택합니다.

데이터소스 추가를 선택합니다.

데이터 소스 servicenow 플러그인을 찾으려면 다음을 입력하십시오.

ServiceNow URL 입력:

저장 및 테스트를 선택합니다. “ServiceNow 연결 확인”이라는 녹색 메시지가 표시되어야 합니다.

대시보드 예시

미리 만들어진 대시보드는 플러그인에 포함되어 있으며 대시보드 탭 아래의 데이터 소스 구성 페이지를 통해 가져올 수 있습니다.

사용량

쿼리 편집기에서 데이터를 반환하는 방법에는 두 가지가 있습니다.

  • TableAPI

  • 애그리게이트 API

사용자는 현재 다음과 같이 사전 정의된 테이블을 쿼리하는 방법 중에서 선택할 수 있습니다.

  • 변경

  • 인시던트

또는 기타 (사용자 지정 테이블) 옵션을 사용하는 API 기반 테이블 및 필드 목록 참조 v1.4.0 이 옵션을 사용하면 데이터 원본을 설정하는 데 사용한 사용자가 사용할 수 있는 모든 테이블에 있는 ServiceNow 데이터를 쿼리할 수 있습니다.

사용자 지정 테이블 옵션은 사전 정의된 테이블 목록과 동일한 기능을 모두 지원해야 합니다.

TableAPI 쿼리

TableAPI는 테이블 패널에 표시하기에 적합한 데이터를 반환합니다. 이를 통해 표시할 필드의 정렬된 선택과 필터링 옵션을 사용할 수 있습니다. 쿼리 편집기는 쿼리에서 반환되는 행 수를 제한하는 필드도 제공합니다.

이전 쿼리의 결과를 보여주는 예제 테이블 패널

표시

표시 행은 표시할 필드의 선택기를 제공합니다. 필드를 여러 개 지정할 수도 있습니다. 필드는 지정된 순서대로 정확하게 반환됩니다.

디스플레이 값

Display Values 플래그를 사용하면 쿼리가 숫자 값 대신 사용자에게 친숙한 값 또는 디스플레이 값을 반환합니다.

예를 들어 이 플래그가 1 없는 심각도는 심각도만 표시됩니다. 1 플래그가 활성화된 경우 표시되는 값은 다음과 같습니다1 - High.

ServiceNow API 설명서에 따르면 이는 성능에 부정적인 영향을 미칠 수 있습니다.

참고

[...] 표시 값을 지정하면 데이터베이스에서 직접 읽지 않고 다른 필드 및 레코드를 참조하는 작업이 포함될 수 있으므로 성능 문제가 발생할 수 있습니다.

필터 (일반)

필터 행은 여러 필드 및 값 기준에 따라 표시된 행을 좁힐 수 있는 기능을 제공합니다.

모든 필터는 AND 또는 OR 연산과 결합됩니다.

다음 필드는 사용자 지정 테이블을 사용하지 않을 때 사용할 수 있습니다 (이 목록은 향후 확장될 예정).

Active Asset Group Assigned To Escalation Issue Number Description Priority State Type Change Risk Change State Start Date End Date On Hold

사용자 지정 테이블을 선택하면 Service Now API에서 필드가 자동으로 채워집니다.

날짜 필터
시간 필드 연산자
개장 시간 오늘 또는 그 이전, 오늘 말고 오늘 이전 또는 그 이전, 오늘 또는 그 이후 타임스탬프 자바스크립트:gs.Daysago (30)
활동 마감일
휴무일
마감일
예상 시작
재개장 시간
해결 날짜
작업 종료
작업 시작
시간 무시

추가 날짜 값은 https://developer.servicenow.com/app.do #! 을 참조하십시오. /api_doc? v=뉴욕&ID=R_SGSYS-DateGenerate_s_S

연산자 (일반, 문자열 기반)
  • Starts With(다음으로 시작)

  • Ends With

  • 좋아요

  • 마음에 안 들어요

  • 같음

  • 같지 않음

  • Is Empty

연산자 (시간 기반)
  • 오늘

  • 오늘은 안돼

  • 이전

  • 당시 또는 그 이전

  • After

  • 날짜 또는 이후

값 선택은 선택한 필터 유형에 따라 달라집니다.

  • 부울 필터에는 참/거짓 옵션이 있습니다.

  • 텍스트 필터를 사용하면 어떤 값이든 입력할 수 있습니다.

  • 에스컬레이션, 우선순위에는 고정된 숫자 값 세트가 있습니다.

정렬 기준

정렬 기준 행은 여러 필드 및 값 기준에 따라 표시된 행을 좁힐 수 있는 기능을 제공합니다.

모든 필터는 AND 연산과 결합됩니다. 추가 운영자에 대한 지원이 추가될 예정입니다.

Limit

너무 많은 데이터가 반환되지 않도록 행 제한을 지정할 수 있습니다. 기본값은 25입니다.

시간 필드

이를 Time Field 통해 쿼리된 데이터를 시계열로 변환할 수 있습니다. 데이터가 시계열로 처리된다는 것은 대시보드/패널의 시간 범위에 속하지 않는 선택한 “시간 필드”의 값은 표시되지 않음을 의미합니다.

사용되는 기본 시간 필드는 “Open At”이지만 시간 값을 포함하는 사용 가능한 모든 필드로 변경할 수 있습니다.

특수 값인 “Ignore Time (시간 무시)" 이 제공되어 “지금까지의” 결과를 확인할 수 있을 뿐만 아니라 필터를 통해 표시되는 데이터를 제어할 수 있습니다.

애그리게이트API 쿼리 (통계)

AggregateAPI는 항상 평균, 최소, 최대, 합계 등의 집계와 함께 지표를 반환합니다. 필터링은 쿼리 범위를 좁히는 데도 사용할 수 있습니다.

표시

표시 행은 표시할 지표를 위한 선택기를 제공합니다. 지표를 여러 개 지정할 수도 있습니다.

필터 (일반)

집계 필터는 테이블 옵션과 마찬가지로 필드 및 값 기준에 따라 표시된 지표의 범위를 좁힐 수 있는 기능을 제공합니다.

모든 필터는 AND 연산과 결합됩니다. 추가 운영자에 대한 지원이 추가될 예정입니다.

통계 필터 옵션은 TableAPI와 동일합니다.

집계

지표 집계에는 네 가지 유형과 “개수”가 있습니다.

  • 평균

  • 최소

  • Maximum

  • Sum

  • 개수 - 쿼리에서 반환된 지표의 “수”를 반환합니다.

그룹화 기준

이 선택기는 지표를 더 작은 집계로 분할할 수 있는 기능을 제공합니다. “우선 순위”별로 그룹화하면 우선 순위가 “태그”이고 고유 값이 구분된 메트릭이 반환됩니다.

템플릿 작성

쿼리에 이름을 하드코딩하는 대신 변수를 대신 사용할 수 있습니다. 변수는 대시보드 상단의 드롭다운 선택 상자로 표시됩니다. 이 드롭다운 상자를 사용하여 대시보드에 표시되는 데이터를 변경할 수 있습니다.

쿼리 변수를 추가하고 이를 템플릿 값으로 참조하는 방법은 쿼리 변수 섹션의 예제를 참조하십시오.

쿼리 변수

해당 유형의 템플릿 변수를 추가하면 카테고리 이름Query, 키 이름 또는 드롭다운 선택 상자로 표시되는 키 값 등의 항목을 반환할 수 있는 쿼리를 작성할 수 있습니다.

예를 들어 템플릿 변수 Query 설정에 다음과 같은 쿼리를 categories 지정하여 모든 값을 포함하는 변수를 만들 수 있습니다.

쿼리 설정을 선택하면 유형필드를 선택할 수 있는 필터 섹션이 표시됩니다. 현재 유형은 인시던트 및 변경으로 제한됩니다. 유형을 선택하면 해당 유형에 적용할 수 있는 필드 목록이 제공됩니다. 유형과 필드를 선택하면 하단에 해당 유형/필드에 사용할 수 있는 옵션을 보여주는 값 미리보기가 표시됩니다. 이러한 값은 대시보드의 드롭다운 목록에 표시되며, 이 목록을 템플릿과 함께 사용하여 대시보드 패널의 데이터를 필터링할 수 있습니다.

예를 들어 범주라는 이름의 변수를 추가한 다음 유형 = 인시던트, 필드 = 범주를 선택하면 범주에 대한 옵션 목록이 표시됩니다. 그런 다음 패널에 필터를 추가하고 Category Equals $ {category} 를 선택하면 대시보드 드롭다운 목록에서 선택한 해당 범주에 대한 데이터만 패널 데이터에 표시됩니다.

범주별 인시던트 대시보드를 가져와서 예를 확인하십시오.

쿼리에 변수 사용

두 가지 구문이 있습니다.

$<varname>이름이 지정된 hostname 템플릿 변수를 사용한 예:

[[varname]]이름이 지정된 템플릿 변수를 사용한 예hostname:

알림

표준 Grafana 알림이 지원됩니다. 그래프 패널에 정의된 모든 쿼리를 사용하여 알림을 생성할 수 있습니다.

다음은 쿼리 및 알림의 예입니다. 이 쿼리는 미해결 중대하고 우선순위가 높은 모든 인시던트의 그래프를 반환합니다.

이 알림은 우선순위가 높은 미해결 문제가 5개 이상인 경우 시작됩니다.

경고 규칙을 테스트하면 경고 규칙의 출력이 표시되고 상태 기록을 선택하면 경고가 정상에서 보류 중, 경고로 전환되는 것을 확인할 수 있습니다.

알림이 보류 중인 동안에는 그래프 보기에는 수직선이 표시되고 상단의 하트 아이콘이 주황색으로 바뀝니다.

알림 기준이 충족되면 규칙이 빨간색으로 바뀝니다.

그래프 보기에서는 빨간색 수직선이 나타나고 상단의 하트 아이콘이 빨간색으로 바뀝니다.

인시던트 작성 및 알림

베타 기능

  • ServiceNow 데이터 소스의 알림 채널을 구성하세요.

이렇게 하면 구성된 사용자를 사용하여 이 데이터 소스의 인스턴스에 인시던트를 생성하는 Grafana 알림 ServiceNow 채널이 구성됩니다.

이 작업을 수행하려면 ServiceNow 데이터 소스 사용자에게 인시던트 작성 권한이 있어야 합니다.

HTTP 프록시 사용

HTTP 프록시를 사용하는 경우 Amazon Managed Grafana는 다음 환경 변수를 프록시 위치로 설정해야 합니다.

  • HTTP_PROXY(또는 http_proxy)

    • 전체 경로 - http://host:port

    • 아니면 그냥: host:port

  • HTTPS_PROXY(또는https_proxy):

    • 전체 경로 - https://host:port

    • 아니면 그냥: host:port

주석

Grafana 주석은 이 데이터 v1.4.0소스의 베타 기능입니다. 주석을 사용하면 그래프에 이벤트를 오버레이할 수 있습니다.

주석 쿼리는 몇 가지 사소한 차이점을 제외하고 표준 쿼리 편집기와 동일한 옵션을 지원합니다.

  • “표시” 열은 하나만 선택할 수 있습니다. 이 문제는 향후 개선 사항에서 수정될 예정입니다.

  • 시간 필드는 필수입니다.

FAQ

ITSM 역할 플러그인이 없으면 어떻게 되나요?

다음 작업을 수행하려면 관리자 액세스가 필요합니다.

옵션 1: Grafana 사용자에게 모든 테이블에 대한 액세스를 허용하는 관리자 권한을 부여합니다.

옵션 2: 역할을 생성하고 Grafana에서 액세스해야 하는 모든 테이블에 ACL을 적용합니다.

다음 작업을 수행하려면 관리자 액세스가 필요합니다.

  1. 로그인한 관리자는 security_admin에 대한 액세스 권한을 높여야 합니다.

    1. 오른쪽 상단 탐색 창에서 프로필 아이콘을 선택합니다. 프로필 아이콘에는 드롭다운 캐럿 표시기가 있습니다.

    2. 드롭다운 목록에서 역할 승격을 선택합니다.

    3. 표시된 모달에서 security_admin 확인란을 선택합니다.

    4. 확인을 선택합니다.

  2. 원하는 명명 규칙을 사용하여 새 역할을 생성합니다.

    1. 왼쪽의 시스템 보안 => 사용자 및 그룹 => 역할에서 역할 섹션으로 이동합니다.

    2. 상단에서 새로 만들기를 선택합니다.

    3. 역할 이름과 관련 설명을 입력합니다.

    4. 제출을 선택합니다.

  3. 새 사용자를 만들거나 필요한 역할을 가진 기존 사용자를 수정합니다.

    1. 2단계에서 생성한 역할

    2. 개인화_사전

    3. 선택을 개인화하세요

    4. cmdb_read (이렇게 하면 모든 cmdb 테이블에 대한 읽기 액세스 권한이 부여됨)

  4. 필수 테이블 및 필드에 대한 테이블 ACL을 생성합니다.

    1. sys_db_object 테이블에 대한 ACL을 생성합니다.

      1. 두 번째 검색 헤더 열에 이름을 입력하고 Enter 키를 누릅니다. sys_db_object

      2. 필터링된 결과에는 테이블이 표시되어야 합니다. 레코드를 탐색하려면 테이블을 선택합니다.

      3. 탭 섹션에서 컨트롤을 선택합니다.

      4. 페이지 하단에서 [액세스 제어] 탭이 선택되었는지 확인합니다.

      5. 새로 만들기를 선택하여 ACL을 생성합니다.

      6. 작업 선택을 읽기로 변경합니다.

      7. 화면 하단의 역할 필요 섹션에서 새 행 삽입을 선택 (두 번 클릭) 하고 생성한 역할을 검색합니다.

      8. 생성한 역할을 선택한 후 녹색 체크 표시를 선택합니다.

      9. 화면 하단에서 [Submit] 을 선택하여 ACL을 생성한 다음, 모달이 나타나면 [Continue] 를 선택합니다.

  5. 특정 sys_db_object 필드에 대한 ACL을 생성합니다. 이름, 레이블, 표시 이름 및 확장 테이블 각각에 대해 다음 단계를 반복해야 합니다.

    1. sys_db_object의 테이블 레코드 보기에서 화면 상단에 가장 가까운 탭 그룹에서 탭을 선택합니다.

    2. 필드 이름을 찾아 선택합니다.

    3. 하단 탭 섹션의 액세스 제어 탭에서 새로 만들기를 선택합니다.

    4. 작업을 읽기로 변경합니다.

    5. 하단 “역할 필요” 표에서 행 삽입 텍스트를 선택 (두 번 클릭) 합니다.

    6. 생성한 역할을 검색하고 녹색 체크 표시를 선택합니다.

    7. 제출을 선택합니다.

    8. 이름, 레이블, 표시 이름, 확장 테이블 등 모든 필수 필드에 대해 이 단계를 반복했는지 확인하십시오.

  6. Grafana에서 쿼리하려는 변경, 인시던트 및 기타 비 CMDB 테이블에서 4.1의 단계를 반복합니다. 4.2의 단계를 반복하지 마세요. 이 단계는 sys_db_object에만 필요합니다.