snow spcs service events¶
Bemerkung
Sie können die Snowpark Container Services nur dann über Snowflake CLI verwenden, wenn Sie über die erforderlichen Berechtigungen zur Nutzung der Snowpark Container Services verfügen.
Rufen Sie Plattformereignisse für einen Dienst-Container ab.
Syntax¶
snow spcs service events
<name>
--container-name <container_name>
--instance-id <instance_id>
--since <since>
--until <until>
--first <first>
--last <last>
--all
--connection <connection>
--host <host>
--port <port>
--account <account>
--user <user>
--password <password>
--authenticator <authenticator>
--private-key-file <private_key_file>
--token-file-path <token_file_path>
--database <database>
--schema <schema>
--role <role>
--warehouse <warehouse>
--temporary-connection
--mfa-passcode <mfa_passcode>
--enable-diag
--diag-log-path <diag_log_path>
--diag-allowlist-path <diag_allowlist_path>
--format <format>
--verbose
--debug
--silent
Argumente¶
name
Bezeichner des Dienstes, zum Beispiel: my_service.
Optionen¶
--container-name TEXT
Name des Containers.
--instance-id TEXT
ID der Dienstinstanz, beginnend mit 0.
--since TEXT
Rufen Sie Ereignisse, die nach diesem Zeitpunkt aufgetreten sind, in der Snowflake-Intervall-Syntax ab.
--until TEXT
Rufen Sie Ereignisse, die vor diesem Zeitpunkt eingetreten sind, in der Snowflake-Intervall-Syntax ab.
--first INTEGER
Rufen Sie nur die ersten N-Ereignisse ab. Kann nicht mit –last verwendet werden.
--last INTEGER
Rufen Sie nur die letzten N-Ereignisse ab. Kann nicht mit –first verwendet werden.
--all
Rufen Sie alle Spalten ab. Standard: false
--connection, -c, --environment TEXT
Name der Verbindung, wie in Ihrer
config.toml
-Datei definiert. Standard:Standard
.--host TEXT
Host-Adresse für die Verbindung. Überschreibt den für die Verbindung angegebenen Wert.
--port INTEGER
Port für die Verbindung. Überschreibt den für die Verbindung angegebenen Wert.
--account, --accountname TEXT
Name, der Ihrem Snowflake-Konto zugewiesen wurde. Überschreibt den für die Verbindung angegebenen Wert.
--user, --username TEXT
Benutzername für die Verbindung zu Snowflake. Überschreibt den für die Verbindung angegebenen Wert.
--password TEXT
Snowflake-Kennwort. Überschreibt den für die Verbindung angegebenen Wert.
--authenticator TEXT
Snowflake-Authentifikator. Überschreibt den für die Verbindung angegebenen Wert.
--private-key-file, --private-key-path TEXT
Dateipfad zum privaten Snowflake-Schlüssel. Überschreibt den für die Verbindung angegebenen Wert.
--token-file-path TEXT
Pfad zu der Datei, die das OAuth-Token enthält, das bei der Verbindung mit Snowflake verwendet werden soll.
--database, --dbname TEXT
Zu verwendende Datenbank. Überschreibt den für die Verbindung angegebenen Wert.
--schema, --schemaname TEXT
Zu verwendendes Datenbankschema. Überschreibt den für die Verbindung angegebenen Wert.
--role, --rolename TEXT
Zu verwendende Rolle. Überschreibt den für die Verbindung angegebenen Wert.
--warehouse TEXT
Zu verwendendes Warehouse. Überschreibt den für die Verbindung angegebenen Wert.
--temporary-connection, -x
Verwendet eine mit Befehlszeilenparametern definierte Verbindung anstelle einer in config definierten. Standard: false
--mfa-passcode TEXT
Für die mehrstufige Authentifizierung (MFA) zu verwendendes Token.
--enable-diag
Führt den Python-Konnektor-Diagnosetest aus. Standard: false
--diag-log-path TEXT
Pfad des Diagnoseberichts. Standard: <temporary_directory>.
--diag-allowlist-path TEXT
Pfad des Diagnoseberichts zur optionalen Zulassungsliste.
--format [TABLE|JSON]
Gibt das Ausgabeformat an. Standard: TABLE.
--verbose, -v
Zeigt Protokolleinträge für die Protokolliergrade
info
und höher an. Standard: false--debug
Zeigt Protokolleinträge für die Protokollebenen
debug
und höher an; Debug-Protokolle enthalten zusätzliche Informationen. Standard: false--silent
Schaltet Zwischenausgaben auf der Konsole aus. Standard: false
--help
Zeigt den Hilfetext für diesen Befehl an.
Nutzungshinweise¶
Bemerkung
Um diesen Befehl zu verwenden, müssen Sie das Feature enable_spcs_service_events
in Ihrer config.toml
-Datei aktivieren, wie gezeigt:
[cli.features]
enable_spcs_service_events = true
Die folgenden Parameter sind erforderlich:
name
--container-name <name>
--instance-id <ID>
Sie können die zeitbasierten Filter
--since
und--until
verwenden, um Ereignisse für einen bestimmten Zeitraum zurückzugeben. Sie können die Zeit als relative Zeit angeben, wie1h
(Stunde) oder2d
(Tage).Sie können die Optionen
--first
und--last
verwenden, um nur eine bestimmte Anzahl von Ereignissen zurückzugeben. Beachten Sie, dass sich diese Optionen gegenseitig ausschließen.
Beispiele¶
Rufen Sie alle Ereignisse für einen bestimmten Dienst ab:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0
Rufen Sie eine Teilmenge der Ereignisse für einen bestimmten Dienst ab:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --first 5 snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 5
Rufen Sie Ereignisse ab, die neuer sind als die letzten fünf Minuten:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --since '5 minutes'
Rufen Sie Ereignisse ab, die älter als eine Stunde sind:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --until '1 hour'
Rufen Sie alle Ereignisse mit allen angezeigten Spalten ab:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --all --last 1
TIMESTAMP | DATABASE NAME | SCHEMA NAME | SERVICE NAME | INSTANCE NAME | CONTAINER NAME | SEVERITY | EVENT NAME | EVENT VALUE -- | -- | -- | -- | -- | -- | -- | -- | -- 2024-12-13 10:01:52.808692 | TESTDB | PUBLIC | LOG_EVENT | 0 | log-printer | INFO | CONTAINER.STATUS_CHANGE | { "message": "Running", "status": "READY" } 2024-12-14 22:27:25.420489 | TESTDB | PUBLIC | LOG_EVENT | 0 | log-printer | INFO | CONTAINER.STATUS_CHANGE | { "message": "Running", "status": "READY" }
Rufen Sie Ereignisse ab, die für JSON-Ausgabe formatiert sind:
snow spcs service events LOG_EVENT --container-name log-printer --instance-id 0 --last 1 --format json
[ { "TIMESTAMP": "2024-12-14T22:27:25.420489", "DATABASE NAME": "TESTDB", "SCHEMA NAME": "PUBLIC", "SERVICE NAME": "LOG_EVENT", "INSTANCE NAME": "0", "CONTAINER NAME": "log-printer", "SEVERITY": "INFO", "EVENT NAME": "CONTAINER.STATUS_CHANGE", "EVENT VALUE": "{\n \"message\": \"Running\",\n \"status\": \"READY\"\n}" } ]