Amazon IVS Real-Time Streaming 모니터링 - Amazon IVS
스테이지 세션이란 무엇인가요?스테이지 세션 및 참가자 보기참가자에 대한 이벤트 보기CloudWatch 지표 액세스CloudWatch 지표: IVS 실시간 스트리밍

Amazon IVS Real-Time Streaming 모니터링

이 문서는 IVS Real-Time Streaming 애플리케이션을 모니터링하는 데 사용할 수 있는 옵션에 대한 세부 정보를 제공합니다.

스테이지 세션이란 무엇인가요?

첫 번째 참가자가 스테이지에 참가하면 스테이지 세션이 시작되고 마지막 참가자가 스테이지에 게시를 중지하면 몇 분 후에 스테이지 세션이 종료됩니다. 스테이지 세션은 이벤트와 참가자를 단기 세션으로 분리하여 장기 세션 디버깅을 지원합니다.

스테이지 세션 및 참가자 보기

콘솔 지침

  1. Amazon IVS 콘솔을 엽니다.

    (AWS Management Console을 통해 Amazon IVS 콘솔에 액세스할 수도 있습니다.)

  2. 탐색 창에서 스테이지를 선택합니다. (탐색 창이 축소된 경우 먼저 햄버거 아이콘을 선택하여 엽니다.)

  3. 스테이지를 선택하여 해당 세부 정보 페이지로 이동합니다.

  4. 스테이지 세션 섹션이 표시될 때까지 페이지를 아래로 스크롤한 다음 세부 정보 페이지를 볼 스테이지 세션을 선택합니다.

  5. 세션의 참가자를 보려면 참가자 섹션이 표시될 때까지 아래로 스크롤한 다음에 Amazon CloudWatch 지표를 포함한 세부 정보 페이지를 볼 참가자를 선택합니다.

참가자에 대한 이벤트 보기

스테이지에 참가하거나 스테이지에 게시하는 동안 오류가 발생하는 등 스테이지에서 참가자의 상태가 변경될 때 이벤트가 전송됩니다. 모든 오류가 이벤트를 일으키는 것은 아닙니다. 예를 들어 클라이언트측 네트워크 오류와 토큰 서명 오류는 이벤트로 전송되지 않습니다. 클라이언트 애플리케이션에서 이러한 오류를 처리하려면 IVS 브로드캐스트 SDK를 사용합니다.

콘솔 지침

  1. 위의 지침에 따라 참가자 세부 정보 페이지로 이동합니다.

  2. 이벤트 섹션이 표시될 때까지 아래로 스크롤합니다. 그러면 참가자 이벤트의 정렬된 목록이 표시됩니다. 참가자를 위해 방출되는 이벤트에 대한 자세한 내용은 Amazon IVS에서 Amazon EventBridge 사용을 참조하세요.

CLI 지침

AWS CLI를 사용하여 스테이지 세션 이벤트에 액세스하는 것은 고급 옵션이며, 먼저 머신에서 CLI를 다운로드하고 구성해야 합니다. 자세한 내용은 AWS Command Line Interface 사용 설명서를 참조하세요.

  1. 스테이지 세션을 나열하여 스테이지 세션을 찾습니다.

    aws ivs-realtime list-stage-sessions --stage-arn <arn>

  2. 스테이지 세션에 대한 참가자를 나열하여 참가자를 찾습니다.

    aws ivs-realtime list-participants --stage-arn <arn> –session-id <sessionId>

  3. 스테이지 세션과 참가자에 대한 이벤트를 나열합니다.

    aws ivs-realtime list-participant-events --stage-arn <arn> --session-id <sessionId> –-participant-id <participantId>

다음은 list-participant-events 호출에 대한 샘플 응답입니다.

{
    "events": [
        {
            "eventTime": "2023-04-04T22:48:41+00:00",
            "name": "JOINED",
            "participantId": "AdRezBl021t0"
        },
        {
            "eventTime": "2023-04-04T22:48:41+00:00",
            "name": "SUBSCRIBE_STARTED",
            "participantId": "AdRezBl021t0",
            "remoteParticipantId": "Ou5b5n5XLMdC"
        },
        {
            "eventTime": "2023-04-04T22:49:45+00:00",
            "name": "SUBSCRIBE_STOPPED",
            "participantId": "AdRezBl021t0",
            "remoteParticipantId": "Ou5b5n5XLMdC"
        },
        {
            "eventTime": "2023-04-04T22:49:45+00:00",
            "name": "LEFT",
            "participantId": "AdRezBl021t0"
        }
    ]
}

CloudWatch 지표 액세스

CloudWatch 지표를 사용하기 위해서는 웹 1.5.0 이상, Android 1.12.0 이상 또는 iOS 1.12.0 이상의 IVS 브로드캐스트 SDK 버전이 필요합니다.

CloudWatch 콘솔 지침

  1. https://console.aws.amazon.com/cloudwatch/에서 CloudWatch 콘솔을 엽니다.

  2. 측면 탐색에서 지표(Metrics) 드롭다운을 확장한 다음 모든 지표(All metrics)를 선택합니다.

  3. 검색 탭에서 왼쪽에 있는 레이블이 없는 드롭다운을 사용하여 채널이 생성된 '홈' 리전을 선택합니다. 리전에 대한 자세한 내용은 글로벌 솔루션, 리전별 제어를 참조하세요. 지원되는 리전 목록은 AWS 일반 참조의 Amazon IVS 페이지를 참조하세요.

  4. 검색 탭 하단 부분에서 IVSRealTime 네임스페이스를 선택하세요.

  5. 다음 중 하나를 수행합니다.

    1. 검색 창에 리소스 ID(ARN의 일부, arn:::ivs:stage/<resource id>)를 입력합니다.

      그리고 나서 IVSRealTime > 스테이지 지표를 선택하세요.

    2. IVSRealTime이 AWS 네임스페이스 아래에서 선택 가능한 서비스로 나타나는 경우 선택하세요. Amazon IVS Real-Time Streaming을 사용하고 Amazon CloudWatch에 지표를 전송하는 경우 나열됩니다. (IVSRealTime이 목록에 없으면 Amazon IVS 지표가 없습니다.)

      그리고 나서 필요할 경우 차원 그룹화를 선택하세요. 아래의 CloudWatch 지표에 사용 가능한 차원이 나열되어 있습니다.

  6. 지표를 선택하여 그래프에 추가합니다. 아래의 CloudWatch 지표에 사용 가능한 지표가 나열되어 있습니다.

또한 스트림 세션의 세부 정보 페이지에서 CloudWatch에서 보기(View in CloudWatch) 버튼을 선택하여 스트림 세션의 CloudWatch 차트에 액세스할 수 있습니다.

CLI 지침

AWS CLI를 사용하여 지표에 액세스할 수도 있습니다. 그러려면 먼저 시스템에 CLI를 다운로드하여 구성해야 합니다. 자세한 내용은 AWS 명령줄 인터페이스 사용 설명서를 참조하세요.

그런 다음, AWS CLI를 사용하여 Amazon 실시간 스트리밍 IVS 지표에 액세스하려면 다음을 수행합니다.

  • 명령 프롬프트에서 다음을 실행합니다.

    aws cloudwatch list-metrics --namespace AWS/IVSRealTime

자세한 내용은 Amazon CloudWatch 사용 설명서에서 Amazon CloudWatch 지표 사용을 참조하세요.

CloudWatch 지표: IVS 실시간 스트리밍

Amazon IVS는 AWS/IVSRealTime 네임스페이스에서 다음 지표를 제공합니다.

CloudWatch 지표를 사용하기 위해서는 반드시 웹 브로드캐스트 SDK 1.5.2 이상을 사용해야 합니다.

차원의 유효한 값은 다음과 같을 수 있습니다.

  • Stage 차원은 리소스 ID(ARN의 일부, arn:::stage/<resource id>)입니다.

  • Participant 차원은 participantID입니다.

  • SimulcastLayer는 "video" MediaType의 경우 "hi", "mid", "low" 또는 "no-rid"이고 "audio" MediaType의 경우 "disabled"입니다. 이 값도 비워둘 수 있습니다.

  • MediaType 차원은 '비디오' 또는 '오디오'(문자열) 입니다.

지표 차원 설명

DownloadPacketLoss

Stage

각 샘플은 특정 구독자가 IVS 서버에서 다운로드하는 동안 손실한 패킷의 백분율을 나타냅니다.

단위: 백분율

유효 통계: 평균, 최대, 최소 - 구성된 간격 동안 패킷 손실의 평균 수, 가장 많은 수 또는 가장 적은 수(각각)입니다.

DownloadPacketLoss

Stage,Participant

게시자이기도 한 구독자의 경우 참가자별로 DownloadPacketLoss를 필터링합니다. 샘플은 구독자가 IVS 서버에서 다운로드하는 동안 손실한 패킷의 백분율을 나타냅니다. 참가자가 게시자이기도 한 경우에만 샘플이 내보내집니다.

단위: 백분율

유효 통계: 평균, 최대, 최소 - 구성된 간격 동안 드롭된 프레임의 평균 수, 가장 많은 수 또는 가장 적은 수(각각)입니다.

DroppedFrames

Stage

각 샘플은 특정 구독자가 드롭한 프레임의 백분율을 나타냅니다.

단위: 백분율

유효 통계: 평균, 최대, 최소 - 구성된 간격 동안 드롭된 프레임의 평균 수, 가장 많은 수 또는 가장 적은 수(각각)입니다.

DroppedFrames

Stage,Participant

게시자이기도 한 구독자의 경우 참가자별로 DroppedFrames를 필터링합니다. 샘플은 구독 참가자와 스테이지의 모든 게시자 사이에서 삭제된 프레임의 백분율을 나타냅니다. 참가자가 게시자이기도 한 경우에만 샘플이 내보내집니다.

단위: 백분율

유효 통계: 평균, 최대, 최소 - 구성된 간격 동안 드롭된 프레임의 평균 수, 가장 많은 수 또는 가장 적은 수(각각)입니다.

PublishBitrate

Stage

방출된 샘플은 특정 게시자가 비디오와 오디오 데이터를 모두 전송하는 전체 속도(모든 동시 방송 계층 전반에서 집계)를 나타냅니다.

단위: 비트/초

유효 통계: 평균, 최대, 최소 - 구성된 간격 동안 비트레이트의 평균 수, 가장 많은 수 또는 가장 적은 수(각각)입니다.

PublishBitrate

Stage, Participant, SimulcastLayer, MediaType

참가자, 동시 방송 계층 및 미디어 종류를 기준으로 PublishBitrate를 필터링하세요. 동시 방송 계층 ID는 브로드캐스트 SDK에 의해 설정됩니다. 동시 방송이 비활성화된 경우 이 계층 ID는 '비활성화됨'으로 설정됩니다. 미디어 종류는 비디오 또는 오디오입니다.

단위: 비트/초

유효 통계: 평균, 최대, 최소 - 구성된 간격 동안 비트레이트의 평균 수, 가장 많은 수 또는 가장 적은 수(각각)입니다.

PublishFramerate

Stage, Participant

주어진 게시자로부터 비디오 프레임이 수신되는 빈도입니다. 이 지표는 RTMP를 통해 게시하는 참가자만 사용할 수 있습니다.

단위: 개수/초

유효한 통계: 평균, 최대, 최소 - 구성된 간격 동안 프레임 속도의 평균 숫자, 가장 큰 숫자 수 또는 가장 작은 숫자(각각)입니다.

Publishers

Stage

스테이지에 게시하는 참가자의 수입니다.

단위: 수

유효 통계: 평균, 최대, 최소

PublishResolution

Stage, Participant, SimulcastLayer, MediaType

프레임 너비 또는 높이 중 작은 값 전반의 픽셀 수입니다. 예를 들어 크기가 1920x1080인 가로 프레임의 경우 게시 해상도는 1080입니다. 크기가 720x1280인 세로 프레임의 경우 게시 해상도는 720입니다.

단위: 수

유효 통계: 평균, 최대, 최소

SubscribeBitrate

Stage

방출된 샘플은 특정 구독자가 비디오와 오디오 데이터를 둘 다 수신하는 전체 속도를 나타냅니다.

단위: 비트/초

유효 통계: 평균, 최대, 최소 - 구성된 간격 동안 비트레이트의 평균 수, 가장 많은 수 또는 가장 적은 수(각각)입니다.

SubscribeBitrate

Stage,Participant,MediaType

게시자이기도 한 구독자의 경우 참가자별로 SubscribeBitrate를 필터링합니다. 샘플은 특정 구독자가 특정 MediaType을 수신하는 비트레이트를 나타냅니다. 구독 참가자가 게시하는 동안에만 샘플이 내보내집니다.

단위: 비트/초

유효 통계: 평균, 최대, 최소 - 구성된 간격 동안 비트레이트의 평균 수, 가장 많은 수 또는 가장 적은 수(각각)입니다.

Subscribers

Stage

스테이지를 구독하는 참가자의 수입니다. 활발하게 게시하고 구독하는 참여자는 게시자 및 구독자로 모두 인정됩니다.

단위: 수

유효 통계: 평균, 최대, 최소