Auf dieser Seite wird beschrieben, wie Sie von der Live Stream API generierte Plattformprotokolle als
Teil von Cloud Logging. Die Live Stream API verwendet den Logging API-Dienstnamen
livestream.googleapis.com
, um kanalbezogene Aktivitäten zu protokollieren.
Hinweise
- Achten Sie darauf, dass Sie die richtigen IAM-Berechtigungen und -Rollen zum Ansehen und Ansehen haben Logs verwalten.
Plattform-Logging aktivieren
Standardmäßig werden die livestream.googleapis.com/channel_activities
-Plattformlogs für
Live Stream API deaktiviert ist. Zum Aktivieren der Logs müssen Sie einen
Wichtigkeitsstufe vor, wenn Sie die Kanalressource erstellen oder aktualisieren.
Fügen Sie zum Aktivieren der Logs das folgende Feld in den JSON-Anfragetext der
projects.locations.channels.create
oder die
projects.locations.channels.patch
-Methode:
"logConfig": { "logSeverity": "SEVERITY_LEVEL" },
Dabei kann SEVERITY_LEVEL
für folgendes stehen:
OFF
DEBUG
INFO
WARNING
ERROR
Nachdem Sie einen Logschweregrad für einen Kanal ausgewählt haben, protokolliert nur die Plattform mit
Schweregraden, die höher oder gleich
dem ausgewählten Schweregrad sind, werden protokolliert.
Lautet der Schweregrad beispielsweise WARNING
, werden nur Logs mit diesem Schweregrad erstellt.
WARNING
und ERROR
werden protokolliert. Wenn der Schweregrad INFO
ist, werden Logs aller
Schweregrade außer DEBUG
werden protokolliert.
Weitere Informationen zu Schweregraden von Logs finden Sie unter LogSeverity.
Plattformlogs ansehen
So rufen Sie Plattformlogs auf:
Console
So rufen Sie Plattformlogs in der Google Cloud Console auf:
Rufen Sie den Log-Explorer auf:
Wählen Sie das entsprechende Google Cloud-Projekt aus.
Geben Sie im Feld Abfrage den folgenden Abfragebefehl ein:
resource.labels.channel_id=CHANNEL_ID resource.labels.location=LOCATION logName="projects/PROJECT_ID/logs/livestream.googleapis.com%2Fchannel_activities"
Dabei gilt:
CHANNEL_ID
ist die ID des Kanals, den Sie debuggen oder überwachen möchten. Beispiel:my-channel
LOCATION
ist der Speicherort des Kanals, den Sie debuggen oder überwachen möchten. Beispiel:us-central1
PROJECT_ID
ist die ID des Projekts, das den Kanal enthält, den Sie debuggen oder überwachen möchten. Beispiel:my-project
Klicken Sie auf Abfrage ausführen.
Weitere Informationen zum Log-Explorer finden Sie unter Übersicht über den Log-Explorer und Log-Explorer verwenden
gcloud
Das gcloud-Befehlszeilentool bietet eine Befehlszeile für Cloud Logging.
Führen Sie den folgenden Befehl aus, um die channel_activities
-Logs für Ihr Projekt aufzurufen:
gcloud logging read "logName:projects/PROJECT_ID/logs/livestream.googleapis.com%2Fchannel_activities" --project=PROJECT_ID
Dabei ist PROJECT_ID
die ID für Ihr Google Cloud-Projekt.
Weitere Informationen zur Verwendung des gcloud-Tools mit Cloud Logging finden Sie unter
gcloud logging
Plattformlogs verwenden
In diesem Abschnitt wird beschrieben, wie Sie bestimmte Plattformlogs für Live Stream API
eventStateChange
eventStateChange
-Logs werden generiert, wenn der Status eines Kanalereignisses
Änderungen. Der Schweregrad eines eventStateChange
-Logs ist ERROR
, wenn der
Der neue Status des Kanalereignisses ist FAILED
. Andernfalls wird der Schweregrad einer
eventStateChange
-Log ist INFO
.
Das folgende Beispiel zeigt ein eventStateChange
-Log:
{ jsonPayload: { @type: "type.googleapis.com/google.cloud.video.livestream.logging.v1.ChannelActivity" eventStateChange: { eventId: "my-ad-break" newState: "SCHEDULED" previousState: "PENDING" } message: "State of event "my-ad-break" changed from "PENDING" to "SCHEDULED"." } ... severity: "INFO" ... }
scte35CommandReceived
scte35CommandReceived
-Logs werden generiert, wenn der Eingabestream ein
SCTE35-Befehl. Der Schweregrad für ein scte35CommandReceived
-Log ist INFO
.
Das folgende Beispiel zeigt ein scte35CommandReceived
-Log:
{ jsonPayload: { @type: "type.googleapis.com/google.cloud.video.livestream.logging.v1.ChannelActivity" scte35CommandReceived: { spliceInfoSection: { ptsAdjustment: "123456789" spliceInsert: { availNum: 0 availsExpected: 0 breakDuration: null componentCount: 0 components: [0] durationFlag: false out0fNetworkIndicator: true programSpliceFlag: true spliceEventCancelIndicator: false spliceEventId: 123456789 spliceImmediateFlag: true spliceTime: null uniqueProgramId: 5 } } } message: "Received inband SCTE35 command, eventID=123456789." } ... severity: "INFO" ... }
streamingStateChange
streamingStateChange
-Logs werden generiert, wenn der Streamingstatus eines Kanals
Änderungen. Der Schweregrad eines streamingStateChange
-Logs ist ERROR
, wenn der
Der neue Status des Kanals ist STREAMING_ERROR
. Andernfalls wird der Schweregrad einer
streamingStateChange
-Log ist INFO
.
Im Folgenden finden Sie ein Beispiel für ein streamingStateChange
-Log, bei dem das vorherige
Zustand ist STREAMING_ERROR
und der neue Status ist STREAMING
:
{ jsonPayload: { @type: "type.googleapis.com/google.cloud.video.livestream.logging.v1.ChannelActivity" message: "streaming state of channel "CHANNEL_ID" changes from "STREAMING_ERROR" to "STREAMING"" streamingStateChange: { newState: "STREAMING" previousState: "STREAMING_ERROR" ... type: "livestream.googleapis.com/Channel" } severity: "INFO" ... }
Sie können dem Feld Abfrage des Log-Explorers zusätzliche Befehle hinzufügen, um die angezeigten Logs einzugrenzen.
Fügen Sie den folgenden Befehl hinzu, um alle streamingStateChange
-Logs aufzurufen, bei denen der neue Status STREAMING
ist:
jsonPayload.streamingStateChange.newState="STREAMING"
Fügen Sie den folgenden Befehl hinzu, damit nur streamingStateChange
-Logs angezeigt werden:
jsonPayload.streamingStateChange.newState:*
streamingError
streamingError
-Logs werden generiert, wenn ein Kanal auf eine Streaming-bezogene
Fehler. Der Schweregrad eines streamingError
-Logs ist ERROR
.
Das folgende Beispiel zeigt ein streamingError
-Protokoll, bei dem die Live Stream API
Berechtigung zum Hochladen von Ausgabedateien in den angegebenen Cloud Storage-Bucket verweigert:
{ jsonPayload: { @type: "type.googleapis.com/google.cloud.video.livestream.logging.v1.ChannelActivity" message: "A live streaming encounters an error." streamingError: { error: { ... message: "Permission denied to access the Cloud Storage bucket "STORAGE_BUCKET_NAME"" ... severity: "ERROR" ... }
Dieser Fehler kann auch auftreten, wenn der angegebene Cloud Storage-Bucket nicht vorhanden ist.
Wenn streamingError.message
die Meldung This is due to an internal
error. If the error persists, please contact support team
anzeigt, kopieren Sie die
und zur Fehlerbehebung an das Supportteam senden.
inputAccept
inputAccept
-Logs werden generiert, wenn ein Eingabestream erfolgreich verbunden wurde
an den Eingabeendpunkt der Live Stream API übergeben. Die Wichtigkeitsstufe von inputAccept
-Logs
ist INFO
.
Das Feld inputStreamProperty
in einem inputAccept
-Log enthält Folgendes:
Informationen zu den Video- und Audio-Substreams des Eingabestreams:
Videostreams |
|
Audiostreams |
|
Mit inputAccept
-Logs können Sie das Format und den Annahmestatus der
Eingabestream:
{ jsonPayload: { @type: "type.googleapis.com/google.cloud.video.livestream.logging.v1.ChannelActivity" inputAccept: { inputAttachment: "input-primary" inputStreamProperty: { audioStreams: [ 0: { audioFormat: { channelCount: 2 channelLayout: [ 0: "fl" 1: "fr" ] codec: "aac" } index: 1 } ] videoStreams: [ 0: { videoFormat: { codec: "h264" frameRate: 60 heightPixels: 720 widthPixels: 1280 ... streamId: "STREAM_ID" } message: "Input stream "STREAM_ID" is accepted by channel "CHANNEL_ID" for input attachment "input-primary"" } ... severity: "INFO" ... }
Fügen Sie den folgenden Befehl in das Feld Abfrage des Log-Explorers ein, um Folgendes aufzurufen:
nur inputAccept
-Logs für einen bestimmten Stream:
jsonPayload.inputAccept.streamId="STREAM_ID"
Dabei ist STREAM_ID
die eindeutige Kennung für einen Stream, der in der Eingabedaten (input) enthalten ist.
Endpunkt-URI.
inputError
inputError
-Logs werden generiert, wenn ein Eingabestream vom
Live Stream API Der Schweregrad für ein inputError
-Log ist ERROR
.
Das folgende Beispiel zeigt ein inputError
-Log, an das ein Eingabestream gesendet wurde.
für einen noch nicht gestarteten Kanal:
{ jsonPayload: { @type: "type.googleapis.com/google.cloud.video.livestream.logging.v1.ChannelActivity" inputError: { error: { ... message: "The channel has not been started yet" } streamId: "STREAM_ID" ... severity: "ERROR" ... }
Das folgende Beispiel zeigt ein inputError
-Log, bei dem ein doppelter Eingabestream
wurde an einen Kanal gesendet, der bereits streamt:
{ jsonPayload: { @type: "type.googleapis.com/google.cloud.video.livestream.logging.v1.ChannelActivity" inputError: { error: { code: 9 message: "input stream "STREAM_ID" has been accepted. Please verify if another input stream has been streaming to the same endpoint." } streamId: "STREAM_ID" ... severity: "ERROR" ... }
Fügen Sie den folgenden Befehl in das Feld Abfrage des Log-Explorers ein, damit nur die Daten angezeigt werden.
inputError
-Logs für einen bestimmten Stream:
jsonPayload.inputError.streamId="STREAM_ID"
Dabei ist STREAM_ID
die eindeutige Kennung für einen Stream, der in der Eingabedaten (input) enthalten ist.
Endpunkt-URI.
inputDisconnect
inputDisconnect
-Logs werden generiert, wenn die Eingabestreams getrennt werden
über die Live Stream API. Mit inputDisconnect
-Logs können Sie prüfen,
unerwartete Unterbrechungen beim Livestream. Der Schweregrad für ein inputDisconnect
Log ist INFO
.
Das folgende Beispiel zeigt ein inputDisconnect
-Log:
{ jsonPayload: { @type: "type.googleapis.com/google.cloud.video.livestream.logging.v1.ChannelActivity" inputDisconnect: { inputAttachment: "input-primary" streamId: "STREAM_ID" } message: "Input stream "STREAM_ID" is disconnected by channel "CHANNEL_ID" for input attachment "input-primary"" ... severity: "INFO" ... }