유형에 변환 추가
이 가이드에서는 Manufacturing Data Engine (MDE)의 지정된 유형에 변환을 추가하는 방법을 설명합니다.
변환 선택
MDE에는 여러 변환이 있습니다. 기본 구성 패키지 는 해당 기본 구성 패키지에서 사용할 수 있는 모든 유형과 연결할 수 있는 두 가지 변환을 제공합니다.
- 그룹 이벤트 변경 변환: 이 변환 은 태그 또는 태그 그룹의 모든 필드를 모니터링하고 모니터링된 값이 이러한 태그 중 하나에서 변경될 때마다 이벤트를 생성합니다. 이 변환은 모든 원형 유형과 연결될 수 있습니다.
- 창 변환: 이 변환 은 유형의 모든 태그에 창 함수를 적용합니다. 창 은 일정 기간 동안 여러 레코드를 단일 레코드로 요약하는 것을 의미합니다. 창 변환 은 모든 원형의 모든 유형과 연결될 수 있습니다. 1분에서 60분까지 태그의 레코드를 요약할 수 있습니다. 변환 의 결과는 선택한 기간 동안 값 표현식의 요약 값이 포함된 원시 메시지입니다.
기본 구성 패키지는 이러한 두 변환에서 내보낸 원시 메시지를 처리하는 데 필요한 메시지 클래스, 파서, 유형을 제공합니다. 각 변환 에서 생성된 원시 메시지를 처리하기 위해 제공되는 두 가지 유형은 다음과 같습니다.
group-event-change-records: 그룹 이벤트 변경 변환의 출력 메시지 대상 유형입니다.window-transformation-records: 창 변환의 출력 메시지 대상 유형입니다.
변환을 활성화하려면 유형 웹 인터페이스에서 지정된 변환을 선택하거나 구성 API 엔드포인트를 사용하여 유형과 연결해야 합니다.
사용 가능한 변환 나열
MDE 시스템에서 사용 가능한 변환 목록을 탐색하려면 다음 단계를 따르세요.
REST
사용 가능한 변환을 나열하는 전용 구성 관리자 API 엔드포인트가 있습니다.
GET /configuration/v1/transformations
사용 가능한 변환 및 기능이 포함된 다음 JSON을 반환합니다.
{
"transformations": [
{
"name": "eventChange",
"displayName": "MDE Event Change",
"description": "Monitors the value of one or more tag that has a common group key. Fires an event whenever any of the contributing tags changes its value",
"disabled": false,
"sample": {
"keyExpression": {
"displayName": "Key Expression",
"description": "A SpEL expression that extracts the group key from the MDE message.proto which groups one or more tags as one unit whose values will be monitored for a change. The key must evaluate to a string",
"value": "#message['tagName']"
},
"valueExpression": {
"displayName": "Value Expression",
"description": "A SpEL expression that extracts the value from the MDE message.proto to be monitored for a change. The value must evaluate to a string",
"value": "#message['data']['numeric'].toString()"
}
}
},
{
"name": "window",
"displayName": "MDE Numeric Value Windowing",
"description": "Create a periodic stats event that provides values such as average, min, and max for an expression that extracts a numeric value from the tag messages",
"disabled": false,
"sample": {
"durationMinutes": {
"displayName": "Window Duration in Minutes",
"description": "A positive integer that represents how long the window will summarize events before producing the summary tag, this is in the granularity of minutes and it cannot be higher than 2 hours",
"value": "1"
},
"valueExpression": {
"displayName": "Value Expression",
"description": "A SpEL expression that extracts the value from the MDE message.proto to be used as the numeric value of the tags that will be summarized. The value must evaluate to a number, and it's internally out",
"value": "#message['data']['numeric']"
},
"id": {
"displayName": "Window Unique ID",
"description": "A unique ID that represents this instance of the window transformation, this should be unique if you are adding multiple instances of the window transformation to the same type",
"value": "1-min-window"
}
}
}
]
}
콘솔
웹 인터페이스를 사용하여 '유형' 섹션에서 지정된 유형의 유형 버전 수정 메뉴를 열고 패널의 변환 및 연결 섹션을 펼칩니다.
유형에 변환 연결
기존 유형을 사용 가능한 변환에 연결하면 해당 유형의 모든 태그가 변환됩니다. 변환의 결과는 변환된 유형 의 MDE에서 새 태그로 수집됩니다. 변환된 태그 이름에는 원래 태그 이름과 변환 이름에서 파생된 새 이름이 있습니다.
유형을 변환에 연결하는 단계는 다음과 같습니다.
REST
변환을 지정된 유형에 연결하려면 PATCH
메서드를 구성 관리자 API의 이 엔드포인트에서 호출합니다.
PATCH /configuration/v1/types/TYPE_NAME/versions/VERSION_NUMBER
요청의 본문에는 유형에 연결할 변환 목록과 구성 매개변수 값이 포함되어야 합니다.
{
"transformations": [
{
"window": {
"id": "WINDOW_TRANSFORMATION_IDE",
"durationMinutes": WINDOW_TRANSFORMATION_MINUTES,
"valueExpression": "VALUE_EXPRESSION_VALUE"
}
},
{
"eventChange": {
"keyExpression": "KEY_EXPRESSION_VALUE",
"valueExpression": "VALUE_EXPRESSION_VALUE"
}
}
]
}
이전 샘플 호출에서 다음 항목을 바꿉니다.
TYPE_NAME: 수정할 유형의 이름입니다.VERSION_NUMBER: 수정할 유형의 버전입니다.
창 변환을 구성하기 위해 본문 에서 다음 항목을 바꿉니다.
WINDOW_TRANSFORMATION_ID: 변환에서 처리된 후 원래 태그 이름에도 연결되는 변환의 고유 식별자입니다.WINDOW_TRANSFORMATION_MINUTES: 적용할 창의 기간(분)입니다.VALUE_EXPRESSION_VALUE: 값 필드로 모니터링되는 태그 프로토의 요소입니다. 숫자 기본 태그의 경우입니다#message['data']['numeric'].
이벤트 변경 변환을 구성하기 위해 본문 에서 다음 항목을 바꿉니다.
KEY_EXPRESSION_VALUE: 함께 모니터링해야 하는 태그를 그룹화하는 데 사용되는 태그 프로토의 요소입니다. 단일 태그를 모니터링하려면 여야 합니다.#message['tagName']VALUE_EXPRESSION_VALUE: 값 변경을 모니터링하는 데 사용되는 태그 프로토의 요소입니다.String으로 확인해야 합니다. 숫자 기본 태그의 경우#message['data']['numeric'].toString()입니다.
콘솔
변환을 유형에 연결하려면 '유형' 탭에서 '유형 버전 수정' 웹 인터페이스 섹션을 엽니다.
'변환 및 연결' 섹션을 펼칩니다.
변환 을 추가하려면 목록에서 필요한 변환을 선택하고 '추가' 를 클릭합니다.
그런 다음 필요한 매개변수를 제공하고 '저장'을 클릭합니다.
창 변환 의 매개변수는 다음과 같습니다.
WINDOW_TRANSFORMATION_ID: 변환에서 처리된 후 원래 태그 이름에도 연결되는 변환의 고유 식별자입니다.WINDOW_TRANSFORMATION_MINUTES: 적용할 창의 기간(분)입니다.VALUE_EXPRESSION_VALUE: 값 필드로 모니터링되는 태그 프로토의 요소입니다. 숫자 기본 태그의 경우입니다#message['data']['numeric'].
이벤트 변경 변환 의 매개변수는 다음과 같습니다.
KEY_EXPRESSION_VALUE: 함께 모니터링해야 하는 태그를 그룹화하는 데 사용되는 태그 프로토의 요소입니다. 단일 태그를 모니터링하려면 여야 합니다.#message['tagName']VALUE_EXPRESSION_VALUE: 값 변경을 모니터링하는 데 사용되는 태그 프로토의 요소입니다.String으로 확인해야 합니다. 숫자 기본 태그의 경우#message['data']['numeric'].toString()입니다.