ApsaraVideo Live:Obtain an RTS TraceID

Background

Troubleshooting playback issues by IP address and playback time requires searching massive logs and becomes harder when one IP has multiple sessions. Real-Time Streaming (RTS) assigns a globally unique TraceID to each playback session, enabling Alibaba Cloud to pinpoint issues quickly. Correlate the RTS TraceID with your client logs for efficient troubleshooting.

You can obtain an RTS TraceID in the following ways:

• Obtain an RTS TraceID from a demo player

• Obtain an RTS TraceID in a production environment

Obtain from a demo player

Mobile client (Android/iOS)

Use the mobile client demo (Run demos) to play a stream. After playback starts, click Troubleshoot on the RTS mobile player page. The RequestId in the dialog box is the TraceID.

Web client (H5)

Use the web client demo (Run demos) to play a stream. After playback starts, click Troubleshoot on the RTS web player page to view the TraceID.

Obtain in a production environment

In a production environment, the SDK is integrated into your application instead of using Alibaba Cloud demos.

Mobile client (Android/iOS)

Obtain the TraceID through an event callback from the ApsaraVideo Player SDK.

• Android

  // Listen for the onInfo callback of the player and parse the DemuxerTraceID message.
  mRtsAliPlayer.setOnInfoListener(infoBean -> {
      if (infoBean.getCode() == InfoCode.DemuxerTraceID) {
          String traceId = infoBean.getExtraMsg();
  });

• iOS

  // Listen for the onPlayerEvent callback of the player and parse the DemuxerTraceID message.
  - (void)onPlayerEvent:(AliPlayer*)player eventWithString:(AVPEventWithString)eventWithString description:(NSString *)description {
      switch (eventWithString) {
          case EVENT_PLAYER_DEMUXER_TRACE_ID:
              {
                  NSString *traceId = description;
              }
                  break;
              default:
                  break;
      }
  }

Web client (H5)

• Obtain a TraceID from the signaling request response

  H5 signaling requests are HTTP POST requests. Obtain the TraceID from the Network Type tab in your browser developer tools. For example, the signaling request for artc://player.alicdn.com/a/b_RTS is http(s)://player.alicdn.com/a/b_RTS.

  1. Go to the RTS web player.

  2. Enter an RTS-enabled streaming URL, such as artc://player.alicdn.com/a/b_RTS.

  3. Click Start to play the RTS stream.

  4. Press F12 to open the browser developer tools and select the Network tab.

  5. Search for the signaling request http(s)://player.alicdn.com/a/b_RTS and view the TraceID in the Response.

• ApsaraVideo Player SDK for Web

  Subscribe to the rtsTraceId event to obtain the TraceID:

  // This event is triggered when an RTS stream is successfully pulled. In the callback function, the traceId parameter is the TraceID of the stream, and the source parameter is the streaming URL of the current RTS stream.
  player.on('rtsTraceId', function(event) {
      console.log('EVENT rtsTraceId', event.paramData);
  })