Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

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

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

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

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

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

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

리소스	로그 설명
멀티캐스트 그룹 소비자 활성화	그룹 범위 및 영역에 대해 활성화된 특정 멀티캐스트 소비자 VPC 네트워크의 멀티캐스트 소비자에 대한 그룹 멤버십 이벤트 로그입니다. 이러한 로그는 멀티캐스트 소비자 구성과 해당 멀티캐스트 소비자 네트워크가 포함된 프로젝트에서 사용할 수 있습니다. 공유 VPC를 사용하는 경우 호스트 프로젝트입니다. 멀티캐스트 그룹 소비자 활성화의 로깅 사용 설정을 참조하세요.

리소스

로그 설명

멀티캐스트 그룹 소비자 활성화

그룹 범위 및 영역에 대해 활성화된 특정 멀티캐스트 소비자 VPC 네트워크의 멀티캐스트 소비자에 대한 그룹 멤버십 이벤트 로그입니다.

이러한 로그는 멀티캐스트 소비자 구성과 해당 멀티캐스트 소비자 네트워크가 포함된 프로젝트에서 사용할 수 있습니다. 공유 VPC를 사용하는 경우 호스트 프로젝트입니다.

멀티캐스트 그룹 소비자 활성화의 로깅 사용 설정을 참조하세요.

로깅된 이벤트

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

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

IGMP 참여에 성공하면 두 개의 로그 메시지가 표시됩니다. 먼저 IGMP join request received 메시지가 표시되고 이어서 IGMP consumer joined 메시지가 표시됩니다.
이미 그룹에 성공적으로 참여한 멀티캐스트 소비자의 경우 연결 유지 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 컨트롤 플레인이 그룹에서 멀티캐스트 소비자를 삭제했습니다.
`IGMP entitlement rejected`	Google Cloud 컨트롤 플레인이 참여 요청을 수신했지만 다음과 같이 필요한 멀티캐스트 소비자 구성이 완료되지 않아 요청을 거부했습니다. 멀티캐스트 소비자 VPC 네트워크 구성이 완료되지 않았습니다. 멀티캐스트 소비자 VPC 네트워크 구성이 도메인의 멀티캐스트 인프라로 전파되지 않았습니다. 멀티캐스트 소비자가 IGMP에 대해 구성되지 않았습니다. 이 이벤트는 멀티캐스트 그룹 소비자 활성화 리소스의 로그에서만 사용할 수 있습니다.

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

이 섹션에서는 멀티캐스트 소비자 구성이 포함된 프로젝트에서 사용할 수 있는 그룹 멤버십 이벤트 로그의 형식을 설명합니다.

이러한 로그는 멀티캐스트 그룹 범위 및 영역에 대해 활성화된 특정 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 네트워크의 그룹 멤버십 이벤트 로깅을 구성하는 방법을 설명합니다.

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

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

이 태스크에 필요한 권한

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

권한

networkservices.multicastGroupConsumerActivations.update

역할

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

gcloud

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

  gcloud 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을 사용합니다.

API

멀티캐스트 그룹 소비자 활성화의 로깅을 사용 설정하거나 중지하려면 multicastGroupConsumerActivations.patch 메서드를 사용합니다.

  PATCH https://networkservices.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/multicastGroupConsumerActivations/GROUP_CONSUMER_ACTIVATION_NAME?updateMask=logConfig
  {
    "logConfig": {"enabled": "LOGGING_ENABLED"}
  }

다음을 바꿉니다.

PROJECT_ID: 프로젝트의 ID
GROUP_CONSUMER_ACTIVATION_NAME: 멀티캐스트 그룹 소비자 활성화의 이름
ZONE: 멀티캐스트 그룹 소비자 활성화의 영역
LOGGING_ENABLED: 멤버십 이벤트 로깅이 사용 설정되어 있는지 여부를 지정합니다.
- 로깅을 사용 설정하려면 true로 설정합니다.
- 로깅을 사용 중지하려면 false로 설정합니다.

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

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

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

콘솔

Google Cloud 콘솔에서 로그 탐색기 페이지로 이동합니다.
로그 탐색기로 이동
멀티캐스트 그룹 멤버십 이벤트 로그를 보려면 모든 리소스 목록에서 다음 모니터링 리소스 유형 중 하나를 선택합니다.
- 멀티캐스트 소비자 VPC 네트워크 관리자가 네트워크의 그룹 멤버십 이벤트 로그를 보려면 멀티캐스트 그룹 소비자 활성화를 선택합니다.