멀티캐스트 그룹 멤버십 이벤트 로그 보기

프리뷰

이 제품에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

이 페이지에서는 IGMP 참여와 같은 멀티캐스트 그룹 멤버십 이벤트를 모니터링하는 데 사용할 수 있는 로그에 관한 정보를 제공하고 이러한 로그를 사용 설정하고 보는 방법을 설명합니다.

이 로그를 사용하면 멀티캐스트 소비자의 참여 및 탈퇴 시점, 그룹에 있는 멀티캐스트 소비자 수와 같은 멀티캐스트 그룹의 활동을 파악하는 데 도움이 됩니다.

그룹 멤버십 이벤트 로그 정보

Google Cloud 는 멀티캐스트의 그룹 멤버십 이벤트 로그를 Cloud Logging에 씁니다.

이 표에는 로그를 수신하는 프로젝트를 비롯하여 각 리소스 유형에서 사용할 수 있는 로그의 요약이 나와 있습니다. 로깅되는 이벤트 및 로그 형식에 관한 자세한 내용은 다음 섹션을 참조하세요.

리소스	로그 설명
멀티캐스트 그룹 범위	그룹 범위의 모든 멀티캐스트 소비자에 대한 그룹 멤버십 이벤트 로그입니다. 이 로그는 멀티캐스트 관리자 프로젝트에서만 사용할 수 있습니다. 전역 멀티캐스트 그룹 범위와 영역 멀티캐스트 그룹 범위 활성화 모두에서 로깅을 구성할 수 있습니다. 멀티캐스트 그룹 범위의 로깅 사용 설정을 참조하세요.
멀티캐스트 그룹 소비자 활성화	그룹 범위 및 영역에서 활성화된 특정 멀티캐스트 소비자 VPC 네트워크의 멀티캐스트 소비자에 대한 그룹 멤버십 이벤트 로그입니다. 이러한 로그는 멀티캐스트 소비자 리소스가 포함된 프로젝트에서 사용할 수 있습니다. 이는 멀티캐스트 도메인의 토폴로지에 따라 멀티캐스트 관리자 프로젝트이거나 별도의 멀티캐스트 소비자 프로젝트일 수 있습니다. 멀티캐스트 그룹 소비자 활성화의 로깅 사용 설정을 참조하세요.

로깅된 이벤트

이 섹션에서는 Cloud Logging에서 멀티캐스트에 대해 로깅되는 그룹 멤버십 이벤트를 설명합니다.

멀티캐스트 소비자가 그룹에 참여하기 위해 IGMP 멤버십 보고서를 전송하면 다음과 같은 로그 메시지가 표시됩니다.

• IGMP 참여에 성공하면 두 개의 로그 메시지가 표시됩니다. 먼저 IGMP join request received 메시지가 표시되고 이어서 IGMP consumer joined 메시지가 표시됩니다.
• IGMP 참여에 실패하면 두 개의 로그 메시지가 표시됩니다. 먼저 IGMP join request received 메시지가 표시되고 이어서 IGMP join request rejected due to * 메시지가 표시됩니다.
• 이미 그룹에 성공적으로 참여한 멀티캐스트 소비자의 경우 연결 유지 IGMP 참여 요청 시 단일 IGMP join request received 메시지가 표시됩니다.

로깅된 이벤트 및 해당 설명의 전체 목록은 다음 표를 참조하세요.

이벤트	설명
IGMP join request received	Google Cloud 컨트롤 플레인에서 참여 요청을 수신했습니다. 이 메시지는 참여가 완료되었음을 확인하지 않습니다. 멀티캐스트 소비자가 IGMP 프로토콜의 일부로 주기적으로 전송하는 연결 유지 요청을 비롯하여 각 참여 요청이 로깅됩니다.
IGMP consumer joined	Google Cloud 컨트롤 플레인이 그룹에 멀티캐스트 소비자를 추가했습니다. 이 이벤트가 도메인의 멀티캐스트 인프라로 전파되면 멀티캐스트 소비자가 멀티캐스트 트래픽을 수신하기 시작합니다. 이 이벤트는 항상 IGMP join request received 이벤트 다음에 발생합니다.
IGMP consumer left	Google Cloud 컨트롤 플레인이 멀티캐스트 소비자로부터 명시적인 IGMP 탈퇴 요청을 수신하고 요청을 적용했습니다.
IGMP consumer timed out	멀티캐스트 소비자가 연결 유지 요청으로 응답하는 것을 중지했으므로 Google Cloud 컨트롤 플레인이 그룹에서 멀티캐스트 소비자를 삭제했습니다.
Consumer removed due to configuration change	소비자 엔드포인트가 삭제되어 Google Cloud 컨트롤 플레인이 그룹에서 멀티캐스트 소비자를 삭제했습니다. 예를 들어 소비자 인스턴스 또는 프로젝트가 삭제되었을 수 있습니다.
IGMP join request rejected due to full tree	Google Cloud 컨트롤 플레인에서 참여 요청을 수신했지만 멀티캐스트 그룹이 이미 전체 용량에 도달했기 때문에 요청을 거부했습니다.
IGMP join request rejected due to missing quota	Google Cloud 컨트롤 플레인에서 참여 요청을 수신했지만 멀티캐스트 소비자 VPC 네트워크가 이미 VPC 네트워크당 멀티캐스트 소비자 VM에 대한 할당량을 모두 사용하고 있으므로 요청을 거부했습니다.
IGMP join request rejected due to unknown reason	Google Cloud 컨트롤 플레인에서 참여 요청을 수신했지만, 전용 이유가 없는 오류로 인해 요청을 거부했습니다.
IGMP entitlement rejected	Google Cloud 컨트롤 플레인이 참여 요청을 수신했지만 다음과 같이 필요한 멀티캐스트 소비자 구성이 완료되지 않아 요청을 거부했습니다. 멀티캐스트 소비자 VPC 네트워크 구성이 완료되지 않았습니다. 멀티캐스트 소비자 VPC 네트워크 구성이 도메인의 멀티캐스트 인프라에 전파되지 않았습니다. 멀티캐스트 소비자가 IGMP용으로 구성되지 않았습니다. 이 이벤트는 멀티캐스트 그룹 소비자 활성화 리소스의 로그에서만 사용할 수 있습니다.
Consumer network activated	멀티캐스트 그룹 범위에 멀티캐스트 소비자 VPC 네트워크가 활성화되었습니다. 이는 멀티캐스트 그룹 소비자 활성화 리소스 생성에 해당합니다. 이 이벤트는 멀티캐스트 그룹 범위 리소스의 로그에서 멀티캐스트 관리자만 사용할 수 있습니다.
Consumer network deactivated	멀티캐스트 그룹 범위에서 멀티캐스트 소비자 VPC 네트워크가 비활성화되었습니다. 즉, 멀티캐스트 그룹 소비자 활성화 리소스가 삭제되었거나 상태가 OBSOLETE로 변경되었습니다. 이 이벤트는 멀티캐스트 그룹 범위 리소스의 로그에서 멀티캐스트 관리자만 사용할 수 있습니다.

멀티캐스트 그룹 범위의 로그 형식

이 섹션에서는 멀티캐스트 도메인 및 그룹 범위 리소스가 포함된 멀티캐스트 관리자 프로젝트에서 사용할 수 있는 그룹 멤버십 이벤트 로그의 형식을 설명합니다.

이러한 로그는 지정된 멀티캐스트 그룹 범위의 모든 멀티캐스트 소비자에 대한 멤버십 이벤트에 대해 작성됩니다. 멀티캐스트 그룹 범위의 로깅 사용 설정에 설명된 대로 전역 멀티캐스트 그룹 범위와 영역 멀티캐스트 그룹 범위 활성화 리소스 모두에서 로깅을 구성할 수 있습니다.

Cloud Logging 모니터링 리소스 유형 및 로그 이름은 다음과 같습니다.

• 리소스 유형: networkservices.googleapis.com/MulticastGroupRange
• 로그 이름: networkservices.googleapis.com%2Fmulticast_memberships

로그 형식은 로깅된 이벤트 유형에 따라 다릅니다. 자세한 내용은 다음 각 탭의 표를 참조하세요.

IGMP 이벤트

로깅된 이벤트가 IGMP 이벤트인 경우 로그에는 다음 필드가 포함됩니다.

필드	유형	설명
consumerIp	문자열	멀티캐스트 소비자의 기본 내부 IPv4 주소. 예: 10.0.0.1
consumerLocation	문자열	멀티캐스트 소비자 VPC의 영역. 예: us-east5-a
consumerNetwork	리소스	멀티캐스트 소비자 VPC 네트워크. 정수 ID만 채워집니다. 예: consumerNetwork { id: "1234" }
consumerProject	프로젝트	멀티캐스트 소비자 VPC 네트워크가 포함된 프로젝트. 프로젝트 번호만 채워집니다. 예: consumerProject { number: "5678" }
consumerResource	리소스	멀티캐스트 소비자 VM 인스턴스. 정수 ID만 채워집니다. 예: consumerResource { id: "1111" }
consumerResourceProject	프로젝트	멀티캐스트 소비자 VM 인스턴스가 포함된 프로젝트. 공유 VPC를 사용하는 경우와 같이 멀티캐스트 소비자 VPC 네트워크가 포함된 프로젝트와 다를 수 있습니다. 프로젝트 번호만 채워집니다. 예: consumerResourceProject { number: "4321" }
eventDescription	문자열	로깅된 이벤트에 설명된 이벤트 중 하나. 예: IGMP consumer joined
eventTime	문자열	RFC 3339 텍스트 형식의 이벤트 타임스탬프. 예: 2024-10-21T06:46:42.990162973Z
multicastDomain	문자열	멀티캐스트 도메인의 이름. 예: my-domain-name
multicastGroupRange	문자열	멀티캐스트 그룹 범위의 이름. 예: my-group-range-name
multicastIp	문자열	멀티캐스트 그룹의 IP 주소. 예: 224.0.0.1

활성화/비활성화

로깅된 이벤트가 멀티캐스트 소비자 VPC 네트워크 활성화 또는 비활성화인 경우 로그에는 다음 필드가 포함됩니다.

필드	유형	설명
consumerLocation	문자열	멀티캐스트 소비자 VPC 네트워크가 활성화된 영역. 예: us-east5-a
consumerNetwork	리소스	멀티캐스트 소비자 VPC 네트워크. 정수 ID만 채워집니다. 예: consumerNetwork { id: "1234" }
consumerProject	프로젝트	멀티캐스트 소비자 VPC 네트워크가 포함된 프로젝트. 프로젝트 번호만 채워집니다. 예: consumerProject { number: "5678" }
eventDescription	문자열	로깅된 이벤트에 설명된 이벤트 중 하나. 예: Consumer network activated
eventTime	문자열	RFC 3339 텍스트 형식의 이벤트 타임스탬프. 예: 2024-10-21T06:46:42.990162973Z
multicastDomain	문자열	멀티캐스트 도메인의 이름. 예: my-domain-name
multicastGroupRange	문자열	멀티캐스트 그룹 범위의 이름. 예: my-group-range-name

정수 ID는 프로젝트, 네트워크, 인스턴스와 같은 멀티캐스트 소비자의 리소스에서 개인 정보 보호를 유지하기 위해 사용됩니다.

멀티캐스트 그룹 소비자 활성화의 로그 형식

이 섹션에서는 멀티캐스트 소비자 리소스가 포함된 프로젝트에서 사용할 수 있는 그룹 멤버십 이벤트 로그의 형식을 설명합니다. 이 프로젝트는 멀티캐스트 도메인의 토폴로지에 따라 멀티캐스트 관리자 프로젝트이거나 별도의 멀티캐스트 소비자 프로젝트일 수 있습니다.

이 로그는 멀티캐스트 그룹 범위 및 영역에서 활성화된 지정된 VPC 네트워크의 멀티캐스트 소비자에 대한 멤버십 이벤트를 위해 작성됩니다. 멀티캐스트 그룹 소비자 활성화의 로깅 사용 설정에 설명된 대로 영역 멀티캐스트 그룹 소비자 활성화 리소스에서 로깅을 구성할 수 있습니다.

Cloud Logging 모니터링 리소스 유형 및 로그 이름은 다음과 같습니다.

• 리소스 유형: networkservices.googleapis.com/MulticastGroupConsumerActivation
• 로그 이름: networkservices.googleapis.com%2Fmulticast_memberships

로그에는 다음 필드가 포함됩니다.

필드	유형	설명
consumerIp	문자열	멀티캐스트 소비자의 기본 내부 IPv4 주소. 예: 10.0.0.1
consumerLocation	문자열	멀티캐스트 소비자의 영역. 예: us-east5-a
consumerNetwork	리소스	멀티캐스트 소비자 VPC 네트워크. 예: consumerNetwork { name: "my-network" id: "1234" }
consumerProject	프로젝트	멀티캐스트 소비자 VPC 네트워크가 포함된 프로젝트. 예: consumerProject { id: "my-project" number: "5678" }
consumerResource	리소스	멀티캐스트 소비자 VM 인스턴스. 예: consumerResource { name: "my-instance" id: "1111" }
consumerResourceProject	프로젝트	멀티캐스트 소비자 VM 인스턴스가 포함된 프로젝트. 공유 VPC를 사용하는 경우와 같이 멀티캐스트 소비자 VPC 네트워크가 포함된 프로젝트와 다를 수 있습니다. 예: consumerResourceProject { id: "my-instance-project" number: "4321" }
eventDescription	문자열	로깅된 이벤트에 설명된 이벤트 중 하나. 예: IGMP consumer joined
eventTime	문자열	RFC 3339 텍스트 형식의 이벤트 타임스탬프. 예: 2024-10-21T06:46:42.990162973Z
multicastConsumerAssociation	문자열	멀티캐스트 소비자 VPC 네트워크와 도메인 간의 멀티캐스트 소비자 연결의 이름. 예: my-consumer-association-name
multicastGroupConsumerActivation	문자열	멀티캐스트 그룹 소비자 활성화의 이름. 예: my-group-consumer-activation-name
multicastIp	문자열	멀티캐스트 그룹의 IP 주소. 예: 224.0.0.1

멀티캐스트 그룹 범위 로그와 달리 멀티캐스트 그룹 소비자 활성화 로그는 프로젝트와 네트워크에 문자열 ID를 사용합니다. 로그는 멀티캐스트 소비자 리소스가 포함된 프로젝트에서만 사용할 수 있기 때문입니다.

필드 형식 참조

프로젝트

필드	유형	설명
number	문자열(uint64)	자동 생성된 프로젝트의 정수 ID. 예: 5678
id	문자열	사용자가 할당한 프로젝트 ID. 예: my-project

리소스

필드	유형	설명
id	문자열(uint64)	자동 생성된 리소스의 정수 ID. 예: 1111
name	문자열	사용자가 할당한 리소스 이름. 예: my-instance

그룹 멤버십 이벤트 로깅 사용 설정

다음 섹션에서는 멀티캐스트 그룹 범위 또는 특정 멀티캐스트 소비자 VPC 네트워크의 그룹 멤버십 이벤트 로깅을 사용 설정하는 방법을 설명합니다.

멀티캐스트 그룹 범위의 로깅 사용 설정

이 섹션에서는 멀티캐스트 관리자가 기존 멀티캐스트 그룹 범위의 그룹 멤버십 이벤트 로깅을 구성하는 방법을 설명합니다.

새 멀티캐스트 그룹 범위를 만들 때 로깅을 구성하는 방법에 관한 자세한 내용은 멀티캐스트 그룹 범위 만들기를 참조하세요. 멤버십 이벤트 로깅은 기본적으로 사용 설정되어 있지 않습니다.

다음 두 리소스에서 모두 멤버십 이벤트 로깅을 구성할 수 있습니다.

• 멀티캐스트 그룹 범위: 전역 그룹 범위의 로깅 구성은 그룹 범위의 모든 활성화에 적용됩니다.
• 멀티캐스트 그룹 범위 활성화: 영역 그룹 범위 활성화의 로깅 구성이 전역 그룹 범위 구성을 재정의합니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

• networkservices.multicastGroupRanges.update
• networkservices.multicastGroupRangeActivations.update

역할

• 멀티캐스트 관리자(roles/compute.multicastAdmin)

gcloud

• 멀티캐스트 그룹 범위의 로깅을 사용 설정하거나 중지하려면 network-services multicast-group-ranges update 명령어를 사용합니다.

  gcloud beta network-services multicast-group-ranges update GROUP_RANGE_NAME \
      --location=global \
      [--enable-logging | --no-enable-logging]
  

  다음을 바꿉니다.

  • GROUP_RANGE_NAME: 멀티캐스트 그룹 범위의 이름
  • --[no-]enable-logging: 멤버십 이벤트 로깅이 사용 설정되어 있는지 여부를 결정
    • 로깅을 사용 설정하려면 --enable-logging을 사용합니다.
    • 로깅을 중지하려면 --no-enable-logging을 사용합니다.

• 멀티캐스트 그룹 범위 활성화의 로깅을 사용 설정하거나 중지하려면 network-services multicast-group-range-activations update 명령어를 사용합니다.

  gcloud beta network-services multicast-group-range-activations update GROUP_RANGE_ACTIVATION_NAME \
      --location=ZONE \
      [--enable-logging | --no-enable-logging]
  

  다음을 바꿉니다.

  • GROUP_RANGE_ACTIVATION_NAME: 멀티캐스트 그룹 범위 활성화의 이름
  • ZONE: 멀티캐스트 그룹 범위 활성화의 영역
  • --[no-]enable-logging: 멤버십 이벤트 로깅이 사용 설정되어 있는지 여부를 결정
    • 로깅을 사용 설정하려면 --enable-logging을 사용합니다.
    • 로깅을 중지하려면 --no-enable-logging을 사용합니다.

멀티캐스트 그룹 소비자 활성화의 로깅 사용 설정

이 섹션에서는 멀티캐스트 소비자 네트워크 관리자가 VPC 네트워크의 그룹 멤버십 이벤트 로깅을 구성하는 방법을 설명합니다.

멀티캐스트 트래픽을 사용하도록 설정한 특정 VPC 네트워크의 경우 상응하는 멀티캐스트 그룹 소비자 활성화에서 멤버십 이벤트 로깅을 구성할 수 있습니다.

새 멀티캐스트 그룹 소비자 활성화를 만들 때 로깅을 구성하는 방법에 관한 자세한 내용은 VPC 네트워크에서 멀티캐스트 트래픽을 소비하도록 사용 설정하기를 참조하세요. 멤버십 이벤트 로깅은 기본적으로 사용 설정되어 있지 않습니다.

이 태스크에 필요한 권한

이 태스크를 수행하려면 다음과 같은 권한 또는 다음과 같은 IAM 역할을 부여받아야 합니다.

권한

• networkservices.multicastGroupConsumerActivations.update

역할

• 멀티캐스트 관리자(roles/compute.multicastAdmin)

gcloud

멀티캐스트 그룹 소비자 활성화의 로깅을 사용 설정하거나 중지하려면 network-services multicast-group-consumer-activations update 명령어를 사용합니다.

  gcloud beta network-services multicast-group-consumer-activations update GROUP_CONSUMER_ACTIVATION_NAME \
      --location=ZONE \
      [--enable-logging | --no-enable-logging]

다음을 바꿉니다.

• GROUP_CONSUMER_ACTIVATION_NAME: 멀티캐스트 그룹 소비자 활성화의 이름
• ZONE: 멀티캐스트 그룹 소비자 활성화의 영역
• --[no-]enable-logging: 멤버십 이벤트 로깅이 사용 설정되어 있는지 여부를 결정
  • 로깅을 사용 설정하려면 --enable-logging을 사용합니다.
  • 로깅을 중지하려면 --no-enable-logging을 사용합니다.

그룹 멤버십 이벤트 로그 보기

이 섹션에서는 멀티캐스트의 그룹 멤버십 이벤트 로그를 보는 방법을 설명합니다.

자세한 내용은 로그 탐색기 개요를 참조하세요.

콘솔

1. Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.

   로그 탐색기로 이동

2. 멀티캐스트 그룹 멤버십 이벤트 로그를 보려면 모든 리소스 목록에서 다음 모니터링 리소스 유형 중 하나를 선택합니다.

   • 멀티캐스트 관리자가 그룹의 모든 멀티캐스트 소비자에 대한 그룹 멤버십 이벤트 로그를 보려면 멀티캐스트 그룹 범위를 선택합니다.
   • 멀티캐스트 소비자 VPC 네트워크 관리자가 네트워크의 그룹 멤버십 이벤트 로그를 보려면 멀티캐스트 그룹 소비자 활성화를 선택합니다.

다음 단계

• 멀티캐스트 모니터링 가능성 개요 보기
• 멀티캐스트의 흐름 로그 보기
• 멀티캐스트의 멤버십 측정항목 모니터링