Machinery에 프로세스 데이터 연결

Machinery는 현재 대상을 나타내는 프로세스 객체(Process object)와 상태 변화를 나타내는 로그 객체(Log object)를 사용합니다. 기본 도구 모음이나 프로세스 컨테이너에서 데이터 구성 패널을 열 수 있습니다.

현재 객체와 상태 속성

프로세스 객체는 Employee나 Invoice처럼 과정에 참여하는 대상입니다. 문자열 상태 속성의 created, approved 같은 값이 그래프의 상태 노드에 대응합니다.

프로세스 컨테이너 하나는 객체 유형 하나의 상태 속성 하나를 추적합니다. 같은 유형에 큰 단계와 세부 단계를 나타내는 상태 속성이 여러 개 있다면 여러 컨테이너나 계층으로 표현합니다.

여러 객체 유형과 상태 속성을 계층으로 구성한 프로세스 예시

상태 ID를 바꿔도 원천 데이터나 그 값을 사용하는 액션 조건 및 자동화 조건은 자동 갱신되지 않습니다. 현재 객체 유형은 최신 상태만 보여 주므로 전이와 시간에 따른 패턴에는 별도 로그가 필요합니다.

프로세스 객체 유형과 상태 속성을 연결하는 온톨로지 구성 패널

로그 객체 하나는 대상의 한 번 상태 변경을 표현합니다.

필드	자료형	필수	의미
Log ID	String	필수	로그 객체의 기본 키
Process ID	String	필수	추적하는 프로세스 객체의 기본 키 값. 두 유형의 온톨로지 링크에 사용
Old state	String	필수	전이 전 상태
New state	String	필수	전이 후 상태
Timestamp	Timestamp	필수	새 상태에 들어간 시각
isLatest	Boolean	선택	그 프로세스 객체의 가장 최근 로그인지 여부
Duration	Long	선택	이전 상태에 들어간 뒤 경과한 밀리초
Path	String	선택	현재 상태를 포함해 지나온 상태 목록을 직렬화한 JSON 문자열
Action type RID	String	선택	전이를 일으킨 액션 유형. 외부 변경이면 보통 null
Owning RID	String	선택	액션을 실행한 앱의 식별자. 수동과 자동 실행 구분에 사용하며 외부 변경이면 null

Path는 문자열 자료형이며 배열 값을 속성에 직접 넣는 형식이 아닙니다.

로그 유형을 설정하려면 먼저 프로세스 객체 유형이 있어야 합니다. Machinery의 표준 로그 설치를 선택하고 추적할 변경 원천을 정합니다.

프로세스 로그 객체 유형을 설치하는 구성 패널

외부 원천의 변경은 변경 로그 데이터셋을 선택합니다. 플랫폼에서 편집하는 유형은 편집 이력을 켜고 해당 편집을 로그에 포함할 수 있습니다. Machinery가 집계 분석에 사용할 편집 이력 구체화 데이터셋을 자동 생성합니다.

플랫폼 편집 로그 추적은 다중 데이터소스 객체나 행 수준 권한이 있는 유형에는 지원하지 않습니다.

외부 입력은 보통 객체 유형 원천의 상류에 있는 데이터셋이며 다음 간단한 스키마를 사용합니다.

열	자료형	필수	의미
`processId`	String	필수	프로세스 대상을 식별하는 고유 값
`state`	String	필수	새로 들어간 상태
`timestamp`	Timestamp	필수	전이가 발생한 시각
`isDeleted`	Boolean	선택	대상 삭제 여부. 가장 최근 로그의 값이 true이면 객체를 온톨로지에 표시하지 않음

설정을 확인하면 선택한 폴더에 Marketplace 제품을 설치합니다. 제품에는 입력을 로그 스키마로 변환하는 Pipeline Builder 파이프라인, 로그 객체 유형과 프로세스 객체로의 링크가 포함됩니다.

처음 빌드와 로그 유형의 인덱싱을 마쳐야 마이닝 및 모니터링에 사용할 수 있습니다. 파이프라인은 입력 중 하나가 바뀔 때마다 실행하므로 로그는 현재 프로세스 객체보다 빌드 한 번과 인덱싱 한 번만큼 늦습니다. 일반적인 지연은 약 2분에서 5분입니다.

실시간 로그가 필요하면 사용자 지정 로그 객체 유형을 유지해야 합니다. 필수 스키마를 충족하는 기존 사용자 지정 로그를 수동으로 매핑하는 경로도 지원합니다.