snow logs

Ruft Protokolle für ein bestimmtes Objekt ab.

Syntax

snow logs
  <object_type>
  <object_name>
  --from <from_>
  --to <to>
  --refresh <refresh_time>
  --table <event_table>
  --log-level <log_level>
  --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>
  --oauth-client-id <oauth_client_id>
  --oauth-client-secret <oauth_client_secret>
  --oauth-authorization-url <oauth_authorization_url>
  --oauth-token-request-url <oauth_token_request_url>
  --oauth-redirect-uri <oauth_redirect_uri>
  --oauth-scope <oauth_scope>
  --oauth-disable-pkce
  --oauth-enable-refresh-tokens
  --oauth-enable-single-use-refresh-tokens
  --client-store-temporary-credential
  --format <format>
  --verbose
  --debug
  --silent
  --enhanced-exit-codes
Copy

Argumente

object_type

Typ des Objekts, Zum Beispiel Tabelle, Datenbank, Computepool.

object_name

Name des Objekts.

Optionen

--from TEXT

Die Startzeit der abzurufenden Protokolle. Akzeptiert alle ISO8061-Formate.

--to TEXT

Die Endzeit der abzurufenden Protokolle. Akzeptiert alle ISO8061-Formate.

--refresh INTEGER

Wenn gesetzt, werden die Protokolle mit der angegebenen Aktualisierungszeit in Sekunden gestreamt.

--table TEXT

Die Tabelle, die nach Protokollen abgefragt werden soll. Falls nicht angegeben, wird die Standardtabelle verwendet.

--log-level TEXT

Der Protokolliergrad, nach dem gefiltert werden soll. Falls nicht angegeben, wird INFO verwendet. Standard: INFO.

--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 zur Datei mit einem OAuth-Token, 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

Ob ein Verbindungsdiagnosebericht erstellt werden soll. Standard: false

--diag-log-path TEXT

Pfad für den generierten Bericht. Standardmäßig wird das temporäre Verzeichnis des Systems verwendet. Standard: <system_temporary_directory>.

--diag-allowlist-path TEXT

Pfad zu einer JSON-Datei, die allowlist-Parameter enthält.

--oauth-client-id TEXT

Wert der Client-ID, die vom Identitätsanbieter für die Snowflake-Integration bereitgestellt wird.

--oauth-client-secret TEXT

Wert des Client-Geheimnisses, das vom Identitätsanbieter für die Snowflake-Integration bereitgestellt wird.

--oauth-authorization-url TEXT

Endpunkt des Identitätsanbieters, der den Autorisierungscode an den Treiber liefert.

--oauth-token-request-url TEXT

Endpunkt des Identitätsanbieters, der die Zugriffstoken für den Treiber bereitstellt.

--oauth-redirect-uri TEXT

Für die Umleitung des Autorisierungscodes zu verwendende URI.

--oauth-scope TEXT

Bereich, der in der Autorisierungsanfrage des Identitätsanbieters angefordert wird.

--oauth-disable-pkce

Deaktiviert den Proof Key For Code Exchange (PKCE). Standard: False.

--oauth-enable-refresh-tokens

Ermöglicht eine stille Neuauthentifizierung, wenn das aktuelle Zugriffstoken veraltet ist. Standard: False.

--oauth-enable-single-use-refresh-tokens

Ob Sie sich für die Semantik des einmaligen Aktualisierungs-Tokens entscheiden. Standard: False.

--client-store-temporary-credential

Speichern der temporären Anmeldeinformationen.

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

--enhanced-exit-codes

Exit-Fehlercodes nach Art des Fehlers unterscheiden. Standard: false

--help

Zeigt den Hilfetext für diesen Befehl an.

Nutzungshinweise

Der Befehl snow logs greift auf eine Ereignistabelle zu und ruft Protokolle für eine angegebene Entität ab. Standardmäßig sucht der Befehl nach den Protokollen in der Standard-Ereignistabelle SNOWFLAKE.TELEMETRY.EVENTS; Sie können jedoch mit der Option --table eine andere Tabelle auswählen. Weitere Informationen zu Ereignistabellen und Standardwerten finden Sie unter Ereignistabelle erstellen.

Sie können die Optionen --from und --to verwenden, um den Zeitraum zu filtern, für den die Protokolle abgerufen werden sollen. Sie können eine oder beide Optionen verwenden, aber wenn Sie beide verwenden, muss der --from-Zeitpunkt vor dem --to-Zeitpunkt liegen. Die von Ihnen angegebenen Werte für Zeiten müssen dem Standard ISO 8601 entsprechen. Weitere Informationen finden Sie auch in der Dokumentation der Python-Methode datetime.fromisoformat().

Mit der Option --log-level können Sie Nachrichten nach dem Schweregrad filtern. Einige Protokolle enthalten keinen Schweregrad. In diesen Fällen werden die Meldungen für alle --log-level-Werte angezeigt.

Wenn Sie kontinuierliche Aktualisierungen für die Protokolle wünschen, können Sie die Option --refresh verwenden und die Anzahl der Sekunden zwischen den Abrufen angeben. Sie können die Optionen --refresh und --to nicht gleichzeitig verwenden. Um das Streaming der Protokolle zu stoppen, verwenden Sie die Standardunterbrechungstaste Ihres Systems, z. B. CTRL-c bei einem Mac-Terminal.

Beispiele

  • Zeigt die Computepool-Protokolle für einen Zeitraum von einen bestimmten Startzeitpunkt bis jetzt an:

    snow logs compute_pool MY_COMPUTE_POOL --from '2025-04-01 09:00:31'
    
    Copy
    10.12.71.201 - - [01/Apr/2025 09:46:07] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:09] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:14] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:19] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:24] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:29] "GET /healthcheck HTTP/1.1" 200 -
    10.12.71.201 - - [01/Apr/2025 09:46:34] "GET /healthcheck HTTP/1.1" 200 -
    
  • Zeigt die Protokolle für eine bestimmte Ereignistabelle an:

    snow logs compute_pool SNOWCLI_COMPUTE_POOL --table "my_db.my_schema.my_events"
    
    Copy
  • Zeigt die Protokolle für einen Zeitbereich an, bei dem der Startzeitpunkt nach dem Endzeitpunkt liegt, was einen Fehler verursacht:

    snow logs compute_pool SNOWCLI_COMPUTE_POOL --from '2025-03-24 12:00:31' --to "2024-01-03 00:00:00"
    
    Copy
    ╭─ Error ─────────────────────────────────────────────────────────
    │ From_time cannot be later than to_time. Please check the values
    ╰─────────────────────────────────────────────────────────────────