Récupérer les journaux Python bruts
Ce document explique comment utiliser le point de terminaison /api/external/v1/logging/python avec des filtres pour ne récupérer que les données de journal dont vous avez besoin. Il présente les filtres génériques et spécifiques à Google Security Operations, ainsi que des exemples de requêtes pour des cas d'utilisation courants.
Filtrer pour récupérer des détails spécifiques
Vous pouvez utiliser deux types de filtres : les filtres spécifiques à Google SecOps et les filtres génériques.
Filtres spécifiques à Google SecOps
-
labels.integration_name -
labels.integration_instance -
labels.integration_version -
labels.connector_name -
labels.connector_instance -
labels.action_name -
labels.job_name -
labels.correlation_id
Filtres génériques Google SecOps
Pour en savoir plus sur les filtres de journaux intégrés, consultez Créer des requêtes à l'aide du langage de requête Logging.
Exemples de filtres courants
Vous pouvez utiliser les exemples de cette section pour récupérer des informations spécifiques.
Version d'intégration
Pour récupérer les journaux d'une version d'intégration spécifique, utilisez les filtres suivants :
labels.integration_name="INTEGRATION_NAME"AND labels.integration_version="INTEGRATION_NUMBER"
labels.integration_name="Exchange" AND labels.integration_version="19"
Instance de l'intégration
Pour récupérer les journaux d'une instance d'intégration spécifique, utilisez le filtre suivant :
labels.integration_instance="INTEGRATION_NAME"labels.integration_instance="GoogleAlertCenter_1"
Tous les connecteurs
Pour récupérer les journaux de tous les connecteurs, utilisez le filtre suivant avec l'expression régulière :
labels.connector_name=~"^."
Connecteur spécifique
Pour récupérer les journaux d'un connecteur spécifique, utilisez le filtre suivant :
labels.connector_name="CONNECTOR_NAME"labels.connector_name="Exchange Mail Connector v2 with Oauth Authentication"
Tous les jobs
Pour récupérer les journaux de tous les jobs, utilisez le filtre suivant avec l'expression régulière :
labels.job_name=~"^."
Job spécifique
Pour récupérer les journaux d'un job spécifique, utilisez le filtre suivant :
labels.job_name="JOB_NAME"labels.job_name="Cases Collector"
Toutes les actions
Pour récupérer les journaux de toutes les actions, utilisez le filtre suivant avec l'expression régulière :
labels.action_name=~"^."
Action spécifique
Pour récupérer les journaux d'une action spécifique, utilisez le filtre suivant :
labels.action_name="ACTION_NAME"labels.action_name="Enrich Entities"
Actions ayant échoué
Pour récupérer les journaux d'une action ayant échoué, utilisez les filtres suivants ensemble :
labels.action_name="ACTION_NAME" AND SEARCH("Result Value: False")labels.action_name="Enrich Entities" AND SEARCH("Result Value: False")
Rechercher
Utilisez l'opérateur SEARCH pour les recherches en texte libre et pour filtrer en fonction d'étiquettes spécifiques. Il vous permet de rechercher des mots clés, des expressions ou des valeurs dans différents champs des entrées de journal, y compris les étiquettes. Elle effectue une recherche dans plusieurs champs de l'entrée de journal, ce qui est utile pour trouver des enregistrements contenant un texte spécifique dans l'un des champs. Vous pouvez utiliser l'opérateur pour les recherches sensibles ou non à la casse.
Pour effectuer une recherche, utilisez le filtre suivant :
SEARCH("FREE_TEXT")Par exemple, SEARCH("Result Value: False") recherche l'expression exacte Result Value: False dans n'importe quel champ de l'entrée de journal.
Par exemple, SEARCH("Find my CASE SensiTive stRing") effectue une recherche sensible à la casse pour l'expression Find my CASE SensiTive stRing.
Texte du message spécifique
Utilisez le filtre textPayload pour effectuer une recherche dans le champ textPayload de l'entrée de journal, qui correspond au corps principal du message de journal. Il est utile pour filtrer les messages de journal en fonction de leur contenu textuel réel.
Pour récupérer les journaux d'un message spécifique, utilisez le filtre suivant :
textPayload=~"FREE_TEXT"textPayload=~"Invalid JSON payload" recherche les entrées de journal dont la charge utile contient l'expression "Invalid JSON payload".
Job de collecteur de requêtes Siemplify
Pour récupérer les journaux des erreurs du collecteur de demandes, utilisez les filtres suivants ensemble :
textPayload=~(\\".\*----Cases Collector DB started---\*\\") AND severity>="Error"
Erreurs du serveur
Pour récupérer les journaux des erreurs du serveur, utilisez le filtre suivant :
textPayload=~"Internal Server Error"
ID de corrélation
Pour récupérer les journaux d'un ID de corrélation, utilisez le filtre suivant :
labels.correlation_id="CORRELATION_ID"labels.correlation_id="e4a0b1f4afeb43e5ab89dafb5c815fa7"
Filtre d'horodatage
Pour récupérer les journaux, utilisez des codes temporels au format RFC 3339 ou ISO 8601. Dans les expressions de requête, les codes temporels RFC 3339 peuvent spécifier un fuseau horaire avec Z ou ±hh:mm. Tous les codes temporels sont précis à la nanoseconde près.
Pour en savoir plus, consultez Valeurs et conversions.
Pour récupérer les journaux plus récents qu'un code temporel spécifique (UTC), utilisez le filtre suivant :
timestamp>="ISO_8601_format"timestamp>="2023-12-02T21:28:23.045Z"
Pour récupérer les journaux d'un jour spécifique, utilisez les filtres suivants ensemble :
timestamp>="YYYY-MM-DD"AND timestamp<"YYYY-MM-DD"
timestamp>="2023-12-01" AND timestamp<"2023-12-03"
Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.