Live Events - List Get Track Ingest Heartbeats

참조

서비스:: Media Services

API 버전:: 2022-11-01

하나의 라이브 이벤트의 추적 이벤트 가져오기
라이브 이벤트의 하트비트 이벤트 원격 분석을 추적합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
accountName	path	True	string	Media Services 계정 이름입니다.
liveEventName	path	True	string	라이브 이벤트의 이름, 최대 길이는 32입니다. regex 패턴: `^[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의 버전입니다.

응답

Name	형식	Description
200 OK	LiveEventGetTrackIngestHeartbeatsResult	OK. 요청이 성공했습니다.
202 Accepted		수락됨 처리를 위해 요청이 수락되었으며 작업이 비동기적으로 완료됩니다. 비동기 Azure 운영 모니터링에 대한 자세한 내용은 를 참조 https://go.microsoft.com/fwlink/?linkid=2087017 하세요. 헤더 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

샘플 응답

상태 코드:: 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": ""
      }
    }
  ]
}

상태 코드:: 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

상태 코드:: 304

정의

Name	Description
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
LiveEventGetTrackIngestHeartbeatsResult	라이브 이벤트 트랙 수집 심장 박동 결과를 가져옵니다.
LiveEventTrackEvent	라이브 이벤트 트랙 이벤트입니다.
LiveEventTrackEventData	라이브 이벤트 트랙은 하트비트 이벤트 데이터를 수집합니다.
LiveEventTrackEventTrackType	트랙의 유형입니다.
LiveEventTrackEventType	트랙 이벤트의 형식입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	Error 개체.

LiveEventGetTrackIngestHeartbeatsResult

라이브 이벤트 트랙 수집 심장 박동 결과를 가져옵니다.

Name	형식	Description
value	LiveEventTrackEvent[]	get live 이벤트 트랙 이벤트의 결과입니다.

LiveEventTrackEvent

라이브 이벤트 트랙 이벤트입니다.

Name	형식	Description
data	LiveEventTrackEventData	이벤트 데이터입니다.
eventTime	string	발생한 시간 이벤트입니다.
eventType	LiveEventTrackEventType	트랙 이벤트의 형식입니다.

LiveEventTrackEventData

라이브 이벤트 트랙은 하트비트 이벤트 데이터를 수집합니다.

Name	형식	Description
bitrate	integer	트랙의 비트 전송률입니다.
discontinuityCount	integer	지난 20초 동안 검색된 불연속성 수입니다.
healthy	boolean	수집이 정상인지 여부를 나타냅니다.
incomingBitrate	integer	인코더에서 들어오는 데이터 청크에 기반하여 계산된 비트 전송률입니다.
ingestDriftValue	string	지난 1분 동안 들어오는 오디오 또는 비디오 데이터의 지연 속도(분당 초)를 나타냅니다. 데이터가 지난 1분 동안 예상보다 느리게 라이브 이벤트에 도착하면 값은 0보다 큽니다. 데이터가 지연 없이 도착하면 0이고, 오디오 또는 비디오 데이터를 받지 못하면 “n/a”입니다. 예를 들어 기여 인코더가 라이브 콘텐츠를 전송하는 경우 처리 이슈 또는 네트워크 대기 시간으로 인해 속도가 느려지면 1분 동안 총 58초의 오디오 또는 비디오만 전달할 수 있습니다. 이 문제는 분당 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

트랙의 유형입니다.

Name	형식	Description
audio	string
video	string

LiveEventTrackEventType

트랙 이벤트의 형식입니다.

Name	형식	Description
TrackEvent/IngestHeartbeat	string	받은 하트비트를 추적합니다.

다음을 통해 공유