본문 바로가기
WIKI 기술 지식 베이스

URL 파서 (URL Parser)

원문 보기 위키 갱신

URL 파서 프로세서는 URL에서 쿼리 매개변수와 기타 중요한 매개변수를 추출해요. 설정하면 다음 속성이 생성돼요:

출처: 문서

본문

사용 사례 (Use cases)

URL 파서는 URL에서 유용한 정보를 추출하는 데 사용돼요. 예를 들어 nginx에서 온 로그는 필터, 쿼리, 소스를 추출하기 위해 자동으로 파싱되는 URL을 포함할 수 있어요.

로그의 전후 상태 (Before and after state of logs)

예시: 사용자 정의 애플리케이션 로그에서 URL 파싱

전 (Before):

{
  "client": {
    "ip": "10.12.4.20"
  },
  "http": {
    "method": "GET",
    "url": "https://api.example.com/v1/orders?user_id=12345&limit=20",
    "status_code": 200
  },
  "timestamp": 1696945536000
}

URL 파서 (URL Parser)

URL 파서 프로세서를 만들고 http.url 속성을 파싱하도록 구성하세요. 프로세서는 URL을 스키마, 호스트, 경로, 쿼리 매개변수 등의 여러 구조화된 속성으로 추출해요.

처리 후 (After processing):

{
  "client": {
    "ip": "10.12.4.20"
  },
  "http": {
    "method": "GET",
    "url": "https://api.example.com/v1/orders?user_id=12345&limit=20",
    "url_details": {
      "host": "api.example.com",
      "path": "/v1/orders",
      "port": 443,
      "queryString": {
        "user_id": "12345",
        "limit": "20"
      },
      "scheme": "https"
    },
    "status_code": 200
  },
  "timestamp": 1696945536000
}

URL 파서는 URL의 추출된 구성 요소를 포함하는 새 중첩 속성(http.url_details)을 자동으로 추가해요.

API

다음 URL 프로세서 JSON 페이로드와 함께 Datadog Log Pipeline API 엔드포인트를 사용하세요:

{
  "type": "url-parser",
  "name": "Parse the URL from http.url attribute.",
  "is_enabled": true,
  "sources": ["http.url"],
  "target": "http.url_details"
}
매개변수 타입 필수 설명
type String 예 프로세서의 타입.
name String 아니오 프로세서의 이름.
is_enabled Boolean 아니오 프로세서가 활성화되었는지 여부. 기본값: false.
sources Array of strings 아니오 소스 속성 배열. 기본값: http.url.
target String 예 sources에서 추출한 모든 세부 정보를 포함하는 부모 속성의 이름. 기본값: http.url_details.

더 알아보기 (Learn more)