Questa guida spiega come utilizzare i log della piattaforma per risolvere i problemi quando utilizzi gli argomenti di importazione, inclusi i seguenti: argomenti di importazione di Cloud Storage, argomenti di importazione di Azure Event Hubs, argomenti di importazione di Amazon MSK e argomenti di importazione di Confluent Cloud. Google Cloud
Informazioni sui log della piattaforma
Un servizio Google Cloud supportato genera il proprio insieme di log della piattaforma, acquisendo eventi e attività pertinenti al funzionamento del servizio. Questi log della piattaforma contengono informazioni dettagliate su ciò che accade all'interno di un servizio, tra cui operazioni riuscite, errori, avvisi e altri eventi degni di nota.
I log della piattaforma fanno parte di Cloud Logging e condividono le stesse funzionalità. Ad esempio, di seguito è riportato un elenco di funzionalità importanti per i log della piattaforma:
I log sono in genere strutturati come oggetti JSON che consentono ulteriori query e filtri.
Puoi visualizzare i log della piattaforma utilizzando Logging nella console.
I log della piattaforma possono essere integrati anche con Cloud Monitoring e altri strumenti di monitoraggio per creare dashboard, avvisi e altri meccanismi di monitoraggio.
L'archiviazione dei log comporta costi basati sul volume importato e sul periodo di conservazione.
Per ulteriori informazioni sui log della piattaforma, consulta Log di Google Cloud Platform.
Prima di iniziare
Assicurati di aver completato i prerequisiti per la creazione dell'argomento che stai utilizzando:
- Argomento relativo all'importazione in Cloud Storage
- Argomento di importazione di Azure Event Hubs
- Argomento di importazione Amazon MSK
- Argomento di importazione di Confluent Cloud
Ruoli e autorizzazioni richiesti
Prima di iniziare, verifica di avere accesso alla registrazione.
È necessario il ruolo IAM (Identity and Access Management) Visualizzatore log (roles/logging.viewer)
. Per saperne di più sull'accesso a Logging, consulta Controllo dell'accesso con IAM.
Di seguito viene descritto come verificare e concedere l'accesso IAM:
Visualizza l'accesso attuale per verificare l'accesso di ogni entità.
Concedi un ruolo alle entità pertinenti nel tuo progetto.
Informazioni sugli errori di importazione degli argomenti
I topic di importazione possono riscontrare problemi che impediscono l'inserimento corretto dei dati.
Argomenti di importazione di Cloud Storage
I topic di importazione di Cloud Storage possono riscontrare problemi che impediscono l'importazione corretta dei dati. Ad esempio, quando utilizzi un argomento di importazione di Cloud Storage, potresti riscontrare problemi durante l'importazione di un oggetto Cloud Storage o di una parte di un oggetto.
Il seguente elenco descrive i motivi dell'errore di importazione negli argomenti di importazione di Cloud Storage che generano log della piattaforma:
Dimensione messaggio
I singoli messaggi non possono superare i 10 MB. In caso affermativo, l'intero messaggio viene ignorato.
Se utilizzi il formato Avro o Pub/Sub Avro, i blocchi Avro non possono superare i 16 MB. I blocchi Avro più grandi vengono ignorati.
Attributi del messaggio
I messaggi possono avere un massimo di 100 attributi. Qualsiasi attributo aggiuntivo viene eliminato durante l'importazione del messaggio.
Le chiavi attributo non possono superare i 256 byte e i valori non possono superare i 1024 byte. Se il valore è maggiore della dimensione massima, l'intera coppia chiave-valore viene eliminata dal messaggio durante l'importazione.
Per saperne di più sulle linee guida per l'utilizzo di chiavi e attributi dei messaggi, vedi Utilizzare gli attributi per pubblicare un messaggio.
Formattazione Avro
- Assicurati che gli oggetti Avro siano formattati correttamente. La formattazione non corretta impedisce l'importazione del messaggio.
Formato dei dati
- Assicurati di utilizzare una versione Avro supportata. I formati non supportati non vengono elaborati.
Argomenti di importazione di Azure Event Hubs, Amazon MSK e Confluent Cloud
L'importazione di argomenti di Azure Event Hubs, Amazon MSK e Confluent Cloud può riscontrare problemi che impediscono l'importazione dei dati.
Il seguente elenco descrive i motivi dell'errore di importazione negli argomenti di importazione che generano log della piattaforma:
Dimensione messaggio
- I singoli messaggi non possono superare i 10 MB. In caso affermativo, l'intero messaggio viene ignorato.
Attributi del messaggio
I messaggi possono avere un massimo di 100 attributi. Qualsiasi attributo aggiuntivo viene eliminato durante l'importazione del messaggio.
Le chiavi attributo non possono superare i 256 byte e i valori non possono superare i 1024 byte. Se il valore è maggiore della dimensione massima, l'intera coppia chiave-valore viene eliminata dal messaggio durante l'importazione.
Per saperne di più sulle linee guida per l'utilizzo di chiavi e attributi dei messaggi, vedi Utilizzare gli attributi per pubblicare un messaggio.
Abilitare i log della piattaforma
I log della piattaforma sono disattivati per impostazione predefinita per gli argomenti di importazione. Puoi attivare i log della piattaforma quando crei o aggiorni un argomento di importazione. Per disattivare i log della piattaforma, aggiorna l'argomento di importazione.
Attiva i log della piattaforma durante la creazione di un argomento di importazione
Per attivare i log della piattaforma durante la creazione di un argomento di importazione:
Console
-
Nella console Google Cloud , vai alla pagina Argomenti.
Fai clic su Crea argomento.
Viene visualizzata la pagina dei dettagli dell'argomento.
Nel campo ID argomento, inserisci un ID per l'argomento di importazione.
Per ulteriori informazioni sulla denominazione degli argomenti, consulta le linee guida per la denominazione.
Seleziona Aggiungi una sottoscrizione predefinita.
Seleziona Abilita importazione.
- Mantieni le altre impostazioni predefinite.
- Fai clic su Crea argomento.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
Per attivare i log della piattaforma, assicurati che il flag
--ingestion-log-severity
sia impostato suWARNING
o su un livello di gravità inferiore, ad esempioINFO
oDEBUG
. Esegui il comandogcloud pubsub topics create
per l'argomento che stai utilizzando:- Argomento relativo all'importazione in Cloud Storage
- Argomento di importazione di Azure Event Hubs
- Argomento di importazione Amazon MSK
- Argomento di importazione di Confluent Cloud
Ad esempio, per attivare i log della piattaforma in un argomento di importazione di Cloud Storage, includi il flag
--ingestion-log-severity=WARNING
nel comandogcloud pubsub topics create
.gcloud pubsub topics create TOPIC_ID \ --cloud-storage-ingestion-bucket=BUCKET_NAME \ --cloud-storage-ingestion-input-format=INPUT_FORMAT \ --ingestion-log-severity=WARNING
Abilitare i log della piattaforma durante l'aggiornamento di un argomento di importazione
Per abilitare i log della piattaforma durante l'aggiornamento di un argomento di importazione:
Console
Nella console Google Cloud , vai alla pagina Argomenti.
Fai clic sull'argomento di importazione che stai utilizzando (argomento di importazione Cloud Storage, argomento di importazione Azure Event Hubs, argomento di importazione Amazon MSK o argomento di importazione Confluent Cloud).
Nella pagina dei dettagli dell'argomento, fai clic su Modifica.
- Seleziona Abilita log della piattaforma.
Fai clic su Aggiorna.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
Per abilitare i log della piattaforma, assicurati che ingestion-log-severity sia impostato su
WARNING
o su un livello di gravità inferiore, ad esempioINFO
oDEBUG
. Esegui il comandogcloud pubsub topics update
con tutti i flag possibili che specificano le impostazioni per l'argomento che stai utilizzando:- Argomento Importazione in Cloud Storage
- Per evitare di perdere le impostazioni dell'argomento di importazione di Cloud Storage,
assicurati di includere nuovamente gli stessi valori che avevi nel comando
create
originale, ogni volta che aggiorni l'argomento. Se ometti qualcosa, Pub/Sub reimposta l'impostazione sul valore predefinito.
- Per evitare di perdere le impostazioni dell'argomento di importazione di Cloud Storage,
assicurati di includere nuovamente gli stessi valori che avevi nel comando
- Argomento di importazione di Azure Event Hubs
- Argomento di importazione Amazon MSK
- Argomento di importazione di Confluent Cloud
Ad esempio, per aggiornare i log in un argomento di importazione Cloud Storage esistente, includi il flag
--ingestion-log-severity=WARNING
nel comandogcloud pubsub topics create
e includi tutti i possibili valori dei flag che specificano le impostazioni per un argomento di importazione Cloud Storage.gcloud pubsub topics update TOPIC_ID \ --cloud-storage-ingestion-bucket=BUCKET_NAME \ --cloud-storage-ingestion-input-format=INPUT_FORMAT \ --cloud-storage-ingestion-text-delimiter=TEXT_DELIMITER \ --cloud-storage-ingestion-minimum-object-create-time=MINIMUM_OBJECT_CREATE_TIME \ --cloud-storage-ingestion-match-glob=MATCH_GLOB --ingestion-log-severity=WARNING
- Argomento Importazione in Cloud Storage
Disattiva i log della piattaforma
Per disattivare i log della piattaforma per l'argomento di importazione che stai utilizzando, segui questi passaggi:
Console
Nella console Google Cloud , vai alla pagina Argomenti.
Fai clic sull'argomento di importazione che stai utilizzando (argomento di importazione Cloud Storage, argomento di importazione Azure Event Hubs, argomento di importazione Amazon MSK o argomento di importazione Confluent Cloud).
Nella pagina dei dettagli dell'argomento, fai clic su Modifica.
- Deseleziona Abilita log della piattaforma.
Fai clic su Aggiorna.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
Per disattivare i log della piattaforma, assicurati che ingestion-log-severity sia impostato su
DISABLED
. Esegui il comandogcloud pubsub topics update
con tutti i flag possibili che specificano le impostazioni per l'argomento che stai utilizzando:- Argomento Importazione in Cloud Storage
- Per evitare di perdere le impostazioni dell'argomento di importazione di Cloud Storage,
assicurati di includere nuovamente gli stessi valori che avevi nel comando
create
originale, ogni volta che aggiorni l'argomento. Se ometti qualcosa, Pub/Sub reimposta l'impostazione sul valore predefinito originale.
- Per evitare di perdere le impostazioni dell'argomento di importazione di Cloud Storage,
assicurati di includere nuovamente gli stessi valori che avevi nel comando
- Argomento di importazione di Azure Event Hubs
- Argomento di importazione Amazon MSK
- Argomento di importazione di Confluent Cloud
Ad esempio, per disattivare i log in un argomento di importazione Cloud Storage esistente, includi il flag
--ingestion-log-severity=DISABLED
nel comandogcloud pubsub topics update
e tutti i flag possibili che specificano le impostazioni per un argomento di importazione Cloud Storage.gcloud pubsub topics update TOPIC_ID \ --cloud-storage-ingestion-bucket=BUCKET_NAME \ --cloud-storage-ingestion-input-format=INPUT_FORMAT \ --cloud-storage-ingestion-text-delimiter=TEXT_DELIMITER \ --cloud-storage-ingestion-minimum-object-create-time=MINIMUM_OBJECT_CREATE_TIME \ --cloud-storage-ingestion-match-glob=MATCH_GLOB --ingestion-log-severity=DISABLED
- Argomento Importazione in Cloud Storage
Visualizza i log della piattaforma
Per visualizzare i log della piattaforma per l'argomento di importazione che stai utilizzando, svolgi le seguenti operazioni:
Console Google Cloud
Nella console Google Cloud , vai a Esplora log.
Seleziona un Google Cloud progetto.
Se necessario, nel menu Esegui l'upgrade, passa da Visualizzatore log legacy a Esplora log.
Fai clic sul pulsante di attivazione/disattivazione Mostra query.
Per filtrare i log in modo da mostrare solo le voci relative agli argomenti di importazione che stai utilizzando (argomento di importazione Cloud Storage, argomento di importazione Azure Event Hubs, argomento di importazione Amazon MSK o argomento di importazione Confluent Cloud), digita
resource.type="resource.type=pubsub_topic AND severity=WARNING"
nel campo della query e fai clic su Esegui query.Nel riquadro Risultati delle query, fai clic su Modifica periodo di tempo per modificare il periodo di tempo per cui restituire i risultati.
Per saperne di più sull'utilizzo di Esplora log, vedi Utilizzo di Esplora log.
Interfaccia a riga di comando gcloud
Per utilizzare gcloud CLI per cercare i log della piattaforma per i rispettivi argomenti di importazione che stai utilizzando, utilizza il comando gcloud logging read
.
Specifica un filtro per limitare i risultati ai log della piattaforma per gli argomenti di importazione rispettivi che stai utilizzando (argomento di importazione Cloud Storage, argomento di importazione Azure Event Hubs, argomento di importazione Amazon MSK o argomento di importazione Confluent Cloud).
gcloud logging read "resource.type=pubsub_topic AND severity=WARNING"
API Cloud Logging
Utilizza il metodo dell'API Cloud Logging entries.list
.
Per filtrare i risultati in modo da includere solo i log della piattaforma per
gli argomenti di importazione di Cloud Storage,
utilizza il campo filter
. Di seguito è riportato un oggetto richiesta JSON di esempio.
{
"resourceNames":
[
"projects/my-project-name"
],
"orderBy": "timestamp desc",
"filter": "resource.type=\"pubsub_topic\" AND severity=WARNING"
}
Visualizzare e comprendere il formato dei log della piattaforma
La sezione seguente include log della piattaforma di esempio e descrive i campi per i log della piattaforma.
Tutti i campi specifici dei log della piattaforma sono contenuti all'interno di un oggetto jsonPayload
.
Cloud Storage
Errore Avro
{
"insertId": "1xnzx8md4768",
"jsonPayload": {
"@type": "type.googleapis.com/google.pubsub.v1.IngestionFailureEvent",
"cloudStorageFailure": {
"objectGeneration": "1661148924738910",
"bucket": "bucket_in_avro_format",
"objectName": "counts/taxi-2022-08-15T06:10:00.000Z-2022-08-15T06:15:00.000Z-pane-0-last-00-of-01",
"avroFailureReason": {}
},
"topic": "projects/my-project/topics/avro_bucket_topic",
"errorMessage": "Unable to parse the header of the object. The object won't be ingested."
},
"resource": {
"type": "pubsub_topic",
"labels": {
"project_id": "my-project",
"topic_id": "avro_bucket_topic"
}
},
"timestamp": "2024-10-07T18:55:45.650103193Z",
"severity": "WARNING",
"logName": "projects/my-project/logs/pubsub.googleapis.com%2Fingestion_failures",
"receiveTimestamp": "2024-10-07T18:55:46.678221398Z"
}
Campo log | Descrizione |
---|---|
insertId |
Un identificatore univoco per la voce di log. |
jsonPayload.@type |
Identifica il tipo di evento. Sempre type.googleapis.com/google.pubsub.v1.IngestionFailureEvent . |
jsonPayload.cloudStorageFailure.objectGeneration |
Il numero di generazione dell'oggetto Cloud Storage. |
jsonPayload.cloudStorageFailure.bucket |
Il bucket Cloud Storage contenente l'oggetto. |
jsonPayload.cloudStorageFailure.objectName |
Il nome dell'oggetto Cloud Storage. |
jsonPayload.cloudStorageFailure.avroFailureReason |
Contiene dettagli più specifici sull'errore di analisi Avro. Questo campo è vuoto. |
jsonPayload.topic |
L'argomento Pub/Sub a cui era destinato il messaggio. |
jsonPayload.errorMessage |
Un messaggio di errore leggibile. |
resource.type |
Il tipo di risorsa. Sempre pubsub_topic . |
resource.labels.project_id |
L'ID progetto Google Cloud . |
resource.labels.topic_id |
L'ID argomento Pub/Sub. |
timestamp |
Timestamp di generazione della voce di log. |
severity |
Livello di gravità pari a WARNING . |
logName |
Nome del log. |
receiveTimestamp |
Timestamp di ricezione della voce di log. |
Errore di testo
{
"insertId": "1kc4puoag",
"jsonPayload": {
"@type": "type.googleapis.com/google.pubsub.v1.IngestionFailureEvent",
"cloudStorageFailure": {
"bucket": "bucket_in_text_format",
"apiViolationReason": {},
"objectName": "counts/taxi-2022-08-15T06:10:00.000Z-2022-08-15T06:15:00.000Z-pane-0-last-00-of-01",
"objectGeneration": "1727990048026758"
},
"topic": "projects/my-project/topics/large_text_bucket_topic",
"errorMessage": "The message has exceeded the maximum allowed size of 10000000 bytes. The message won't be published."
},
"resource": {
"type": "pubsub_topic",
"labels": {
"topic_id": "large_text_bucket_topic",
"project_id": "my-project"
}
},
"timestamp": "2024-10-09T14:09:07.760488386Z",
"severity": "WARNING",
"logName": "projects/my-project/logs/pubsub.googleapis.com%2Fingestion_failures",
"receiveTimestamp": "2024-10-09T14:09:08.483589656Z"
}
Campo log | Descrizione |
---|---|
insertId |
Un identificatore univoco per la voce di log. |
jsonPayload.@type |
Identifica il tipo di evento. Sempre type.googleapis.com/google.pubsub.v1.IngestionFailureEvent . |
jsonPayload.cloudStorageFailure.objectGeneration |
Il numero di generazione dell'oggetto Cloud Storage. |
jsonPayload.cloudStorageFailure.bucket |
Il bucket Cloud Storage contenente l'oggetto. |
jsonPayload.cloudStorageFailure.objectName |
Il nome dell'oggetto Cloud Storage. |
jsonPayload.cloudStorageFailure.apiViolationReason |
Contiene dettagli sulla violazione dell'API. Questo campo è vuoto. |
jsonPayload.topic |
L'argomento Pub/Sub. |
jsonPayload.errorMessage |
Un messaggio leggibile. |
resource.type |
Tipo di risorsa, sempre pubsub_topic . |
resource.labels.project_id |
Google Cloud ID progetto. |
resource.labels.topic_id |
ID argomento Pub/Sub. |
timestamp |
Timestamp di generazione della voce di log. |
severity |
Livello di gravità pari a WARNING . |
logName |
Nome del log. |
receiveTimestamp |
Ora in cui la voce di log è stata ricevuta da Cloud Logging. |
Amazon MSK
Violazione dell'API
{
"insertId": "k3breb2q",
"jsonPayload": {
"@type": "type.googleapis.com/google.pubsub.v1.IngestionFailureEvent",
"awsMskFailure": {
"apiViolationReason": {},
"clusterArn": "arn:aws:kafka:us-east-1:291552718126:cluster/cluster-ingestion/abb9faea-4070-4eb76-9c21-f98abca92eaf-2",
"kafkaTopic": "msk-topic",
"partitionId": "1",
"offset": "11"
},
"errorMessage": "The value of an attribute in the message exceeded the maximum allowed size of 1024 bytes. Number of bytes in the value: 1025. Key: my header. Value: my very large value …",
"topic": "projects/my-project/topics/msk-import-topic"
},
"resource": {
"type": "pubsub_topic",
"labels": {
"topic_id": "msk-import-topic",
"project_id": "my-project"
}
},
"timestamp": "2025-02-03T16:18:14.693357960Z",
"severity": "WARNING",
"logName": "projects/my-project/logs/pubsub.googleapis.com%2Fingestion_failures",
"receiveTimestamp": "2025-02-03T16:18:16.241643258Z"
}
Campo log | Descrizione |
---|---|
insertId |
Un identificatore univoco per la voce di log. |
jsonPayload.@type |
Identifica il tipo di evento. Sempre type.googleapis.com/google.pubsub.v1.IngestionFailureEvent . |
jsonPayload.awsMskFailure.clusterArn |
L'ARN del cluster da cui viene importato l'argomento. |
jsonPayload.awsMskFailure.kafkaTopic |
Il nome dell'argomento Kafka da cui vengono importati i dati. |
jsonPayload.awsMskFailure.partitionId |
L'ID della partizione che contiene il messaggio di cui non è stato possibile eseguire l'importazione. |
jsonPayload.awsMskFailure.offset |
L'offset all'interno della partizione del messaggio di cui non è stato possibile eseguire l'importazione. |
jsonPayload.awsMskFailure.apiViolationReason |
Contiene dettagli sulla violazione dell'API. Questo campo è vuoto. |
jsonPayload.topic |
L'argomento Pub/Sub. |
jsonPayload.errorMessage |
Un messaggio leggibile. |
resource.type |
Tipo di risorsa, sempre pubsub_topic . |
resource.labels.project_id |
Google Cloud ID progetto. |
resource.labels.topic_id |
ID argomento Pub/Sub. |
timestamp |
Timestamp di generazione della voce di log. |
severity |
Livello di gravità pari a WARNING . |
logName |
Nome del log. |
receiveTimestamp |
Ora in cui la voce di log è stata ricevuta da Cloud Logging. |
Azure Event Hubs
Violazione dell'API
{
"insertId": "i1fbqnb12",
"jsonPayload": {
"@type": "type.googleapis.com/google.pubsub.v1.IngestionFailureEvent",
"azureEventHubsFailure": {
"apiViolationReason": {},
"namespace": "my-namespace",
"eventHub": "my-event-hub",
"partitionId": "1",
"offset": "15"
},
"errorMessage": "The value of an attribute in the message exceeded the maximum allowed size of 1024 bytes. Number of bytes in the value: 1025. Key: my header. Value: my very large value …",
"topic": "projects/my-project/topics/event-hubs-import-topic"
},
"resource": {
"type": "pubsub_topic",
"labels": {
"topic_id": "event-hubs-import-topic",
"project_id": "my-project"
}
},
"timestamp": "2025-02-03T16:18:14.693357960Z",
"severity": "WARNING",
"logName": "projects/my-project/logs/pubsub.googleapis.com%2Fingestion_failures",
"receiveTimestamp": "2025-02-03T14:05:12.338211450Z"
}
Campo log | Descrizione |
---|---|
insertId |
Un identificatore univoco per la voce di log. |
jsonPayload.@type |
Identifica il tipo di evento. Sempre type.googleapis.com/google.pubsub.v1.IngestionFailureEvent . |
jsonPayload.azureEventHubsFailure.namespace |
Lo spazio dei nomi contenente l'hub eventi da cui vengono inseriti i dati. |
jsonPayload.azureEventHubsFailure.eventHub |
Il nome dell'hub eventi da cui vengono inseriti i dati. |
jsonPayload.azureEventHubsFailure.partitionId |
L'ID della partizione che contiene il messaggio di cui non è stato possibile eseguire l'importazione. |
jsonPayload.azureEventHubsFailure.offset |
L'offset all'interno della partizione del messaggio di cui non è stato possibile eseguire l'importazione. |
jsonPayload.azureEventHubsFailure.apiViolationReason |
Contiene dettagli sulla violazione dell'API. Questo campo è vuoto. |
jsonPayload.topic |
L'argomento Pub/Sub. |
jsonPayload.errorMessage |
Un messaggio leggibile. |
resource.type |
Tipo di risorsa, sempre pubsub_topic . |
resource.labels.project_id |
Google Cloud ID progetto. |
resource.labels.topic_id |
ID argomento Pub/Sub. |
timestamp |
Timestamp di generazione della voce di log. |
severity |
Livello di gravità pari a WARNING . |
logName |
Nome del log. |
receiveTimestamp |
Ora in cui la voce di log è stata ricevuta da Cloud Logging. |
Confluent Cloud
Errore di testo
{
"insertId": "i1fbqnb14",
"jsonPayload": {
"@type": "type.googleapis.com/google.pubsub.v1.IngestionFailureEvent",
"confluentCloudFailure": {
"apiViolationReason": {},
"clusterId": "lma-1x18ae",
"kafkaTopic": "confluent-topic",
"partitionId": "1",
"offset": "19"
},
"errorMessage": "The value of an attribute in the message exceeded the maximum allowed size of 1024 bytes. Number of bytes in the value: 1025. Key: my header. Value: my very large value …",
"topic": "projects/my-project/topics/confluent-import-topic"
},
"resource": {
"type": "pubsub_topic",
"labels": {
"topic_id": "confluent-import-topic",
"project_id": "my-project"
}
},
"timestamp": "2025-02-03T16:18:14.693357960Z",
"severity": "WARNING",
"logName": "projects/my-project/logs/pubsub.googleapis.com%2Fingestion_failures",
"receiveTimestamp": "2025-02-03T17:03:11.428221440Z"
}
Campo log | Descrizione |
---|---|
insertId |
Un identificatore univoco per la voce di log. |
jsonPayload.@type |
Identifica il tipo di evento. Sempre type.googleapis.com/google.pubsub.v1.IngestionFailureEvent . |
jsonPayload.confluentCloudFailure.clusterId |
L'ID cluster contenente l'argomento da cui viene eseguito l'inserimento. |
jsonPayload.confluentCloudFailure.kafkaTopic |
Il nome dell'argomento Kafka da cui vengono importati i dati. |
jsonPayload.confluentCloudFailure.partitionId |
L'ID della partizione che contiene il messaggio di cui non è stato possibile eseguire l'importazione. |
jsonPayload.confluentCloudFailure.offset |
L'offset all'interno della partizione del messaggio di cui non è stato possibile eseguire l'importazione. |
jsonPayload.confluentCloudFailure.apiViolationReason |
Contiene dettagli sulla violazione dell'API. Questo campo è vuoto. |
jsonPayload.topic |
L'argomento Pub/Sub. |
jsonPayload.errorMessage |
Un messaggio leggibile. |
resource.type |
Tipo di risorsa, sempre pubsub_topic . |
resource.labels.project_id |
ID progetto Google Cloud. |
resource.labels.topic_id |
ID argomento Pub/Sub. |
timestamp |
Timestamp di generazione della voce di log. |
severity |
Livello di gravità pari a WARNING . |
logName |
Nome del log. |
receiveTimestamp |
Ora in cui la voce di log è stata ricevuta da Cloud Logging. |