User agent processor

출처: 문서

본문

User agent 프로세서

user_agent 프로세서는 이벤트에 포함된 user agent(UA) 문자열을 파싱한 다음, 파싱 결과를 이벤트 데이터에 기록해요.

사용 방법

다음 예시에서 볼 수 있듯이, user_agent 프로세서는 UA 문자열이 담긴 소스인 ua 필드를 가리키고, 파싱된 문자열이 기록될 키인 user_agent를 지정해요:

  processor:
    - user_agent:
        source: "ua"
        target: "user_agent"

다음 예시 이벤트에는 사용자에 대한 정보를 제공하는 문자열이 담긴 ua 필드가 있어요:

{
  "ua":  "Mozilla/5.0 (iPhone; CPU iPhone OS 13_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.1.1 Mobile/15E148 Safari/604.1"
}

user_agent 프로세서는 이 문자열을 Elastic Common Schema(ECS)와 호환되는 형식으로 파싱한 다음, 그 결과를 지정된 target에 추가해요. 다음 예시를 보세요:

{
  "user_agent": {
    "original": "Mozilla/5.0 (iPhone; CPU iPhone OS 13_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.1.1 Mobile/15E148 Safari/604.1",
    "os": {
        "version": "13.5.1",
        "full": "iOS 13.5.1",
        "name": "iOS"
    },
    "name": "Mobile Safari",
    "version": "13.1.1",
    "device": {
        "name": "iPhone"
    }
  },
  "ua":  "Mozilla/5.0 (iPhone; CPU iPhone OS 13_5_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/13.1.1 Mobile/15E148 Safari/604.1"
}

설정 옵션

user_agent 프로세서와 함께 다음 설정 옵션을 사용할 수 있어요.

더 알아보기 (Learn more)

• 원문 전체: https://docs.opensearch.org/latest/data-prepper/pipelines/configuration/processors/user-agent/