ApsaraVideo Live:Obtain an RTS TraceID

Background

Troubleshooting playback issues with details such as a user's IP address and playback time can be inefficient. This method requires searching through massive log volumes to find relevant entries, which is even more difficult when the same user has multiple playback sessions in a short period. Real-Time Streaming (RTS) provides a TraceID for each playback attempt. This globally unique identifier lets Alibaba Cloud quickly locate the specific session associated with a problem. We strongly recommend that you correlate this TraceID with your own client logs.

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 TraceID from a demo player

Mobile client (Android/iOS) demo

For instructions on playing a stream with the mobile demo, see Demo tutorial. After the player connects to the stream, click Troubleshoot on the player screen. The RequestId in the pop-up window is the TraceID.

The pop-up window displays the RequestId and the streaming URL. Click Copy at the bottom to copy this information, which you can then submit in a support ticket for troubleshooting.

Web client (H5) demo

For instructions on playing a stream with the web demo, see Demo tutorial. After the player connects to the stream, click Troubleshoot on the RTS web player page to view the TraceID in the pop-up window.

The pop-up window contains the URL and TraceID fields. Click the Copy button in the lower-right corner to copy this information, which you can then submit in a support ticket for troubleshooting.

Obtain TraceID in a production environment

A production environment refers to your own application with the SDK integrated, as opposed to the Alibaba Cloud demos.

Mobile client (Android/iOS) production environment

Use an event callback from the ApsaraVideo Player SDK to obtain the TraceID.

• Android

  // Listen for the onInfo callback from 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 from 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) production environment

• Obtain the TraceID from the signaling request response

  A signaling request for a web client is an HTTP POST request. You can find the TraceID by using the Network Type tab in your browser developer tools. For example, if the streaming URL is artc://player.alicdn.com/a/b_RTS, the corresponding signaling request is http(s)://player.alicdn.com/a/b_RTS.

  1. Go to the RTS player for web.

  2. On the RTS player for web page, enter a streaming URL for an RTS-enabled stream. For example: artc://player.alicdn.com/a/b_RTS.

  3. Click Start Streaming to play the RTS stream.

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

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

• ApsaraVideo Player SDK for web

  The ApsaraVideo Player SDK for web lets you obtain the RTS TraceID by subscribing to the rtsTraceId event. The following code is an example:

  // This event triggers when an RTS stream is pulled. The event data contains the traceId (the stream's TraceID) and the source (the streaming URL).
  player.on('rtsTraceId', function(event) {
      console.log('EVENT rtsTraceId', event.paramData);
  })