snow spcs service events¶

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¶

[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
  

  Copy

• 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
  

  Copy

• 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'
  

  Copy

• 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'
  

  Copy

• 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
  

  Copy

  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
  

  Copy

  [
       {
           "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}"
       }
   ]