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: Fetch events that are newer than this time ago, in Snowflake interval syntax.
--until TEXT: Fetch events that are older than this time ago, in Snowflake interval syntax.
--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: Path to file with an OAuth token that should be used when connecting to Snowflake.
--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, wie 1h (Stunde) oder 2d (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}"
     }
 ]