데이터 경로 로그 전달

데이터 및 상태 확인 로그는 디버깅 및 유지보수 목적으로 유용합니다. 데이터 경로 로깅 기능을 활성화하면 IBM Cloud® Virtual Private Cloud Application Load Balancer for VPC (ALB)에서 이러한 로그를 계정의 IBM Cloud Logs 대시보드로 전달합니다.

데이터 경로 로깅 기능을 사용 또는 사용 안함으로 설정하려면 다음을 수행할 수 있습니다.

  • 로드 밸런서를 작성하고 전환 단추를 사용 또는 사용 안함으로 설정하십시오.

  • CLI를 사용하여 기존 로드 밸런서에 대해 --logging-datapath-active 특성을 true로 설정하십시오.

  • 데이터 경로 로깅을 사용으로 설정하려면 API를 사용하십시오.

Log Analysis 인스턴스가 없는 경우에는 데이터 경로 로깅을 사용으로 설정하기 전에 인스턴스 하나를 작성해야 합니다.

로그 출력 예제

다음 출력은 IBM Cloud Application Load Balancer for VPC 데이터 경로 로깅의 예입니다.

Sep 28 11:25:04 is-load-balancer crn:v1:bluemix:public:is:us-south:a/a1234567::load-balancer:r006-6ba32c0e-830c-483c-871a-0240c10662cf
{"PRIORITY":"info", "MSG_timestamp":"2020-09-28T03:25:03.136101+00:00", "SentByHost":"150.238.66.162", "MESSAGE":" Connect from 222.72.143.92:38605 to 10.240.128.5:62776 (r006-6ba32c0e-830c-483c-871a-0240c10662cf/HTTP)", "logSourceCRN":"crn:v1:bluemix:public:is:us-south:a/a1234567::load-balancer:r006-6ba32c0e-830c-483c-871a-0240c10662cf", "saveServiceCopy":false}

로그에는 로그 헤더 및 JSON 문자열이 포함되어 있습니다.

로그 헤더는 날짜/시간(Sep 28 11:25:04), 로그 소스(is-load-balancer) 및 로그 소스 CRN(crn:v1:bluemix:public:is:us-south...)으로 빌드됩니다.

데이터 경로 로그는 다음 필드를 포함하는 JSON 문자열입니다.

데이터 경로 로그 필드
필드 이름 유형 설명
PRIORITY 문자열 로그의 심각도에 대한 각 메시지와 연관된 로그 레벨입니다.
MSG_timestamp 문자열 로그가 생성된 시점을 표시하는 시간소인입니다.
SentByHost 문자열 호스트의 IP 주소입니다.
메시지 문자열 로그 파일에 대한 설명입니다.
logSourceCRN 문자열 로그 파일이 CRN에 표시된 계정의 Log Analysis 인스턴스에 저장되는 위치입니다.
saveServiceCopy bool Log Analysis STS에 로그를 저장할지 여부를 표시합니다. 기본값은 false입니다.

다음은 데이터 경로 로그의 JSON 스키마 예제입니다.

{
    "type": "object",
    "properties": {
        "PRIORITY": {
            "type": "string"
        },
        "MSG_timestamp": {
            "type": "string"
        },
        "SentByHost": {
            "type": "string"
        },
        "MESSAGE": {
            "type": "string"
        },
        "logSourceCRN": {
            "type": "string"
        },
        "saveServiceCopy": {
            "type": "boolean"
        }
    }
}

다음 내용을 참고하십시오.

  • PRIORITY는 로그 심각도의 각 메시지와 연관된 로그 레벨입니다. 현재 유일한 선택은 info입니다.
  • MSG_timestamp는 협정 세계시의 시간 소인입니다.
  • SentByHost는 어플라이언스의 VIP입니다. 공용 로드 밸런서의 경우 이는 부동 IP입니다. 개인용 로드 밸런서의 경우에는 개인용 IP입니다.
  • MESSAGE는 로그 메시지의 내용입니다.
  • logSourceCRN은 계정의 로그를 저장하는 데 사용할 Log Analysis 인스턴스를 표시합니다.
  • saveServiceCopy는 (기본적으로) false이며 변경할 수 없습니다.

로그 형식은 내부 업그레이드에 의해 영향을 받을 수 있습니다. 빌드 자동화가 아닌 디버깅 목적으로만 이 메시지를 사용하는 것이 좋습니다.