이벤트 시각화

CDF 이벤트에서 쿼리를 설정하여 필터링하고, Grafana 대시보드에서 그래프에 이벤트를 주석으로 표시할 수 있습니다. 필요에 따라 시간 범위, 표시할 이벤트 및 열을 사용자 지정할 수 있습니다.

테이블에서 이벤트 작업

Grafana의 이벤트 탭을 열어 테이블에서 이벤트를 처리합니다.

쿼리 정의

events 쿼리는 events/list 엔드포인트를 사용하여 데이터를 검색합니다.

형식: events{someFilter=number, otherFilter="string"}

예:

events{externalIdPrefix='WORKORDER', assetSubtreeIds=[{id=12}, {externalId='ext_id'}]}

필터링에 사용할 수 있는 속성은 externalIdPrefix, metadata, assetIds, assetExternalIds, rootAssetIds, assetSubtreeIds, dataSetIds, source, type 및 subtype입니다.

기본적으로 쿼리는 시간 범위 내의 활성 이벤트를 반환하지만 startTime, endTime, activeAtTime, createdTime, lastUpdatedTime 같은 추가적인 시간 필터를 사용하여 쿼리를 사용자 지정할 수 있습니다.

이 예에서는 현재 시간 범위 내에서 시작된 모든 완료된 이벤트를 반환합니다.

events{startTime={min=$__from}, endTime={isNull=false}}

이 예에서는 완료된 이벤트만 반환합니다.

events{endTime={isNull=false}}

클라이언트 측 필터링

=~, !~ 및 != 연산자를 사용하여 더 많은 클라이언트 측 필터링을 지정할 수 있습니다. 여러 필터 사이에 쉼표는 논리 AND로 작동합니다.

형식:

• =~ - 정규식 등식. 정규식과 일치하는 결과를 반환합니다.

• !~ - 정규식 부등식. 정규식과 일치하는 결과를 제외합니다.

• != - 엄격한 부등식. 속성이 주어진 값과 일치하지 않는 항목을 반환합니다.

예:

events{type='WORKORDER', subtype=~'SUB.*'}

참고

클라이언트 측 필터를 기본 필터링 방법으로 사용하지 마십시오. Grafana는 CDF에서 항목을 반환한 후에 필터를 적용하며, CDF가 최대 항목 수(1000)를 반환하는 경우 전체 데이터가 아닐 수 있습니다.

템플릿 생성

$variable_name 구문을 사용하여 템플릿을 생성합니다.

예:

events{type='WORKORDER', subtype=$variable}

필드 이름 바꾸기 및 구성

필드 이름을 바꾸고 구성하려면 변환 탭을 선택합니다.

이벤트를 사용하여 그래프에 주석 추가

주석을 사용하여 Grafana의 그래프에 CDF의 풍부한 이벤트 정보를 오버레이할 수 있습니다.

1. 대시보드의 설정으로 이동하고 주석을 선택합니다.
2. 데이터 원본 필드에서 CDF 프로젝트를 선택합니다.

1. CDF에서 이벤트를 가져오고 필터링하기 위한 쿼리를 지정합니다. 다음 예를 참조하십시오.

   events{type="some", subtype=~"sub.*"}

   위의 쿼리는 type="some" 매개 변수가 있는 이벤트를 요청하고, sub.*와 일치하는 subtype으로 결과를 필터링합니다.

   • 유효한 매개 변수의 전체 목록은 API 설명서를 참조하십시오.

   • 결과를 필터링하는 방법을 알아보십시오.