Live Events - List Get Track Ingest Heartbeats

リファレンス

Service:: Media Services

API Version:: 2022-11-01

1 つのライブイベントの追跡イベントを取得する
ライブイベントの取り込みハートビートイベントテレメトリを追跡します。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}/getTrackIngestHeartbeats?api-version=2022-11-01

URI パラメーター

名前	/	必須	型	説明
accountName	path	True	string	Media Services アカウント名。
liveEventName	path	True	string	ライブイベントの名前。最大長は 32 です。 Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Azure サブスクリプション内のリソースグループの名前。
subscriptionId	path	True	string	Microsoft Azure サブスクリプションの一意識別子。
api-version	query	True	string	クライアント要求で使用される API のバージョン。

応答

名前	型	説明
200 OK	LiveEventGetTrackIngestHeartbeatsResult	OK です。要求は成功しました。
202 Accepted		受理されました。要求は処理のために受け入れられ、操作は非同期的に完了します。非同期 Azure 操作の監視の詳細については、「」を参照 https://go.microsoft.com/fwlink/?linkid=2087017 してください。 Headers Location: string Azure-AsyncOperation: string
Other Status Codes		変更されていません。要求ヘッダーの eTag は、ストレージコンテナー内の eTag と同じです。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するストリーミングエラー応答。

例

Get track ingest heart beats of a LiveEvent

POST https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1/getTrackIngestHeartbeats?api-version=2022-11-01

/** Samples for LiveEvents ListGetTrackIngestHeartbeats. */
public final class Main {
    /*
     * x-ms-original-file: specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-get-track-events.json
     */
    /**
     * Sample code: Get track ingest heart beats of a LiveEvent.
     *
     * @param manager Entry point to MediaServicesManager.
     */
    public static void getTrackIngestHeartBeatsOfALiveEvent(
        com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager
            .liveEvents()
            .listGetTrackIngestHeartbeats(
                "mediaresources", "slitestmedia10", "myLiveEvent1", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "value": [
    {
      "eventType": "TrackEvent/IngestHeartbeat",
      "eventTime": "2022-10-19T22:14:52.33Z",
      "data": {
        "trackName": "audio",
        "trackType": "audio",
        "bitrate": 128000,
        "incomingBitrate": 63496,
        "lastTimestamp": "1635286785",
        "timescale": "1000",
        "overlapCount": 0,
        "discontinuityCount": 0,
        "nonincreasingCount": 0,
        "unexpectedBitrate": true,
        "state": "Running",
        "healthy": null,
        "lastFragmentArrivalTime": "2022-10-19T22:14:51.80Z",
        "ingestDriftValue": "-1",
        "transcriptionState": "",
        "transcriptionLanguage": ""
      }
    },
    {
      "eventType": "TrackEvent/IngestHeartbeat",
      "eventTime": "2022-10-19T22:14:52.11Z",
      "data": {
        "trackName": "video",
        "trackType": "video",
        "bitrate": 2025000,
        "incomingBitrate": 1622016,
        "lastTimestamp": "1635286772",
        "timescale": "1000",
        "overlapCount": 0,
        "discontinuityCount": 0,
        "nonincreasingCount": 0,
        "unexpectedBitrate": null,
        "state": "Running",
        "healthy": true,
        "lastFragmentArrivalTime": "2022-10-19T22:14:51.80Z",
        "ingestDriftValue": "-1",
        "transcriptionState": "",
        "transcriptionLanguage": ""
      }
    },
    {
      "eventType": "TrackEvent/IngestHeartbeat",
      "eventTime": "2022-10-19T22:15:12.90Z",
      "data": {
        "trackName": "audio",
        "trackType": "audio",
        "bitrate": 128000,
        "incomingBitrate": 76705,
        "lastTimestamp": "1635306777",
        "timescale": "1000",
        "overlapCount": 0,
        "discontinuityCount": 0,
        "nonincreasingCount": 0,
        "unexpectedBitrate": null,
        "state": "Running",
        "healthy": true,
        "lastFragmentArrivalTime": "2022-10-19T22:15:11.77Z",
        "ingestDriftValue": "0",
        "transcriptionState": "",
        "transcriptionLanguage": ""
      }
    },
    {
      "eventType": "TrackEvent/IngestHeartbeat",
      "eventTime": "2022-10-19T22:15:12.88Z",
      "data": {
        "trackName": "video",
        "trackType": "video",
        "bitrate": 2025000,
        "incomingBitrate": 1959936,
        "lastTimestamp": "1635306772",
        "timescale": "1000",
        "overlapCount": 0,
        "discontinuityCount": 0,
        "nonincreasingCount": 0,
        "unexpectedBitrate": null,
        "state": "Running",
        "healthy": true,
        "lastFragmentArrivalTime": "2022-10-19T22:15:11.77Z",
        "ingestDriftValue": "0",
        "transcriptionState": "",
        "transcriptionLanguage": ""
      }
    },
    {
      "eventType": "TrackEvent/IngestHeartbeat",
      "eventTime": "2022-10-19T22:15:32.77Z",
      "data": {
        "trackName": "audio",
        "trackType": "audio",
        "bitrate": 128000,
        "incomingBitrate": 76736,
        "lastTimestamp": "1635326793",
        "timescale": "1000",
        "overlapCount": 0,
        "discontinuityCount": 0,
        "nonincreasingCount": 0,
        "unexpectedBitrate": null,
        "state": "Running",
        "healthy": true,
        "lastFragmentArrivalTime": "2022-10-19T22:15:31.76Z",
        "ingestDriftValue": "0",
        "transcriptionState": "",
        "transcriptionLanguage": ""
      }
    }
  ]
}

Status code:: 202

azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveeventoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01

Status code:: 304

定義

名前	説明
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
LiveEventGetTrackIngestHeartbeatsResult	ライブイベントトラックの取り込みハートビートの結果を取得します。
LiveEventTrackEvent	ライブイベントトラックイベント。
LiveEventTrackEventData	ライブイベントトラックでは、ハートビートイベントデータが取り込まれます。
LiveEventTrackEventTrackType	トラックの種類。
LiveEventTrackEventType	トラックイベントの種類。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細です。
message	string	エラーメッセージ。
target	string	エラーのターゲット。

ErrorResponse

エラー応答

名前	型	説明
error	ErrorDetail	error オブジェクト。

LiveEventGetTrackIngestHeartbeatsResult

ライブイベントトラックの取り込みハートビートの結果を取得します。

名前	型	説明
value	LiveEventTrackEvent[]	ライブイベント追跡イベントの取得の結果。

LiveEventTrackEvent

ライブイベントトラックイベント。

名前	型	説明
data	LiveEventTrackEventData	イベントデータ。
eventTime	string	発生した時刻イベント。
eventType	LiveEventTrackEventType	トラックイベントの種類。

LiveEventTrackEventData

ライブイベントトラックでは、ハートビートイベントデータが取り込まれます。

名前	型	説明
bitrate	integer	トラックのビットレート。
discontinuityCount	integer	過去 20 秒間に検出された不連続の数。
healthy	boolean	取り込みが正常かどうかを示します。
incomingBitrate	integer	エンコーダーから送信されるデータチャンクに基づいて計算されたビットレート。
ingestDriftValue	string	直前の 1 分間に受信したオーディオまたはビデオのデータの遅延速度 (1 分あたりの秒数) を示します。直前の 1 分間にデータが期待よりも遅くライブイベントに到着している場合、値は 0 より大きくなります。データが遅延なしで到着した場合は 0 になります。オーディオまたはビデオのデータが受信されなかった場合は "n/a" になります。たとえば、ライブコンテンツで送信しているコントリビューションエンコーダーがあり、それが処理の問題またはネットワーク待ち時間が原因で低速になっている場合は、1 分間に合計 58 秒のオーディオまたはビデオしか配信できないことがあります。これは、1 分あたり 2 秒のドリフトとして報告されます。エンコーダーが追いついて、毎分 60 秒間すべてまたはそれ以上のデータを送信できる場合、この値は 0 と報告されます。エンコーダーとの間で切断または不連続性が発生した場合に、この値がまだ 0 と表示されることがあります。これは、タイムスタンプで遅延しているデータのみが考慮され、データの中断は考慮されないためです。
lastFragmentArrivalTime	string	フラグメントが取り込みエンドポイントに到着した UTC の最後のタイムスタンプ。
lastTimestamp	string	トラックに関して直近 20 秒に受信した最新のタイムスタンプ。
nonincreasingCount	integer	過去 20 秒間に受信したタイムスタンプを持つデータチャンクの数。
overlapCount	integer	過去 20 秒間にタイムスタンプが重複していたデータチャンクの数。
state	string	ライブイベントの状態。
timescale	string	タイムスタンプの表示に使用されるタイムスケール。
trackName	string	トラックの名前。
trackType	LiveEventTrackEventTrackType	トラックの種類。
transcriptionLanguage	string	文字起こし言語の言語コード (BCP-47 形式)。たとえば、"de-de" はドイツ語 (ドイツ) を示します。ビデオトラックのハートビートの場合、またはライブ文字起こしが無効になっている場合、値は空です。
transcriptionState	string	ライブ文字起こしが有効になっている場合、オーディオトラックのハートビートに対するこの値は "On" になります。それ以外の場合は、空の文字列が表示されます。この状態は、ライブ文字起こしの "オーディオ" の種類を追跡する場合にのみ適用されます。他のすべてのトラックの値は空になります。
unexpectedBitrate	boolean	直近 20 秒における予想ビットレートと実ビットレートの差が、許容されている上限を超えているかどうか。

LiveEventTrackEventTrackType

トラックの種類。

名前	型	説明
audio	string
video	string

LiveEventTrackEventType

トラックイベントの種類。

名前	型	説明
TrackEvent/IngestHeartbeat	string	受信したハートビートを追跡します。