Live Events - List Get Track Ingest Heartbeats

Referência

Serviço:: Media Services

Versão da API:: 2022-11-01

Obter eventos de monitorização de um evento em direto
Obtenha uma monitorização da telemetria de eventos de heartbeat de ingestão de um evento em direto.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
accountName	path	True	string	O nome da conta dos Serviços de Multimédia.
liveEventName	path	True	string	O nome do evento em direto, o comprimento máximo é 32. Padrão Regex: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	O nome do grupo de recursos na subscrição do Azure.
subscriptionId	path	True	string	O identificador exclusivo de uma subscrição do Microsoft Azure.
api-version	query	True	string	A versão da API a ser utilizada com o pedido de cliente.

Respostas

Name	Tipo	Description
200 OK	LiveEventGetTrackIngestHeartbeatsResult	OK. O pedido foi efetuada com êxito.
202 Accepted		Aceite. O pedido foi aceite para processamento e a operação será concluída de forma assíncrona. Veja https://go.microsoft.com/fwlink/?linkid=2087017 para obter detalhes sobre as Operações assíncronas de monitorização do Azure. Cabeçalhos Location: string Azure-AsyncOperation: string
Other Status Codes		Não Modificado. A eTag no cabeçalho do pedido é a mesma que a eTag no contentor de armazenamento.
Other Status Codes	ErrorResponse	A resposta do erro de transmissão em fluxo que descreve o motivo pela qual a operação falhou.

Exemplos

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

Resposta da amostra

Código de estado:: 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": ""
      }
    }
  ]
}

Código de estado:: 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

Código de estado:: 304

Definições

Name	Description
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta a erros
LiveEventGetTrackIngestHeartbeatsResult	Obtenha o resultado da ingestão de batimentos cardíacos no registo de eventos em direto.
LiveEventTrackEvent	O evento em direto controla o evento.
LiveEventTrackEventData	O evento em direto controla a ingestão de dados de eventos de batimentos cardíacos.
LiveEventTrackEventTrackType	Tipo de faixa.
LiveEventTrackEventType	O tipo de evento de monitorização.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Resposta a erros

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

LiveEventGetTrackIngestHeartbeatsResult

Obtenha o resultado da ingestão de batimentos cardíacos no registo de eventos em direto.

Name	Tipo	Description
value	LiveEventTrackEvent[]	O resultado dos eventos get live event track.

LiveEventTrackEvent

O evento em direto controla o evento.

Name	Tipo	Description
data	LiveEventTrackEventData	Dados de eventos.
eventTime	string	O evento de hora gerado.
eventType	LiveEventTrackEventType	O tipo de evento de monitorização.

LiveEventTrackEventData

O evento em direto controla a ingestão de dados de eventos de batimentos cardíacos.

Name	Tipo	Description
bitrate	integer	Velocidade de transmissão da faixa.
discontinuityCount	integer	Número de descontinuidades detetadas nos últimos 20 segundos.
healthy	boolean	Indica se a ingestão está em bom estado de funcionamento.
incomingBitrate	integer	Velocidade de transmissão calculada com base em segmentos de dados provenientes do codificador.
ingestDriftValue	string	Indica a velocidade de atraso, em segundos por minuto, dos dados de áudio ou vídeo recebidos durante o último minuto. O valor é maior do que zero se os dados estiverem a chegar ao evento em direto mais lentamente do que o esperado no último minuto; zero se os dados chegaram sem atraso; e "n/a" se não forem recebidos dados de áudio ou vídeo. Por exemplo, se tiver um codificador de contribuição a enviar conteúdos em direto e este estiver a abrandar devido a problemas de processamento ou latência de rede, só poderá fornecer um total de 58 segundos de áudio ou vídeo num período de um minuto. Isto seria reportado como dois segundos por minuto de deriva. Se o codificador conseguir recuperar e enviar todos os 60 segundos ou mais dados a cada minuto, verá este valor comunicado como 0. Se existir uma desconexão ou descontinuação do codificador, este valor poderá continuar a ser apresentado como 0, uma vez que não contabiliza quebras nos dados , apenas os dados atrasados nos carimbos de data/hora.
lastFragmentArrivalTime	string	O último carimbo de data/hora em UTC em que um fragmento chegou ao ponto final de ingestão.
lastTimestamp	string	Carimbo de data/hora mais recente recebido para uma faixa nos últimos 20 segundos.
nonincreasingCount	integer	Número de segmentos de dados com carimbos de data/hora no passado que foram recebidos nos últimos 20 segundos.
overlapCount	integer	Número de segmentos de dados que tinham carimbos de data/hora sobrepostos nos últimos 20 segundos.
state	string	Estado do evento em direto.
timescale	string	Escala temporal na qual os carimbos de data/hora são expressos.
trackName	string	Nome da faixa.
trackType	LiveEventTrackEventTrackType	Tipo de faixa.
transcriptionLanguage	string	O código de idioma (no formato BCP-47) do idioma de transcrição. Por exemplo, "de-de" indica alemão (Alemanha). O valor está vazio para os heartbeats do registo de vídeo ou quando a transcrição em direto está desativada.
transcriptionState	string	Este valor é "Ativado" para heartbeats de faixa de áudio se a transcrição em direto estiver ativada, caso contrário verá uma cadeia vazia. Este estado só é aplicável para controlar o tipo de "áudio" para Transcrição em direto. Todas as outras faixas terão um valor vazio.
unexpectedBitrate	boolean	Se as velocidades de transmissão esperadas e reais forem diferentes do limite permitido nos últimos 20 segundos.

LiveEventTrackEventTrackType

Tipo de faixa.

Name	Tipo	Description
audio	string
video	string

LiveEventTrackEventType

O tipo de evento de monitorização.

Name	Tipo	Description
TrackEvent/IngestHeartbeat	string	Controlar o heartbeat recebido.

Partilhar via