snow spcs service logs

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.

Ruft lokale Protokolle aus einem Dienstcontainer ab.

Syntax

snow spcs service logs
  <name>
  --container-name <container_name>
  --instance-id <instance_id>
  --num-lines <num_lines>
  --previous-logs
  --since <since_timestamp>
  --include-timestamps
  --follow
  --follow-interval <follow_interval>
  --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
Copy

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.

--num-lines INTEGER

Anzahl der abzurufenden Zeilen. Standard: 500.

--previous-logs

Ruft die Protokolle des zuletzt beendeten Containers ab. Standard: false

--since TEXT

Startet den Abruf von Protokollen ab einem bestimmten UTC-Zeitstempel.

--include-timestamps

Nimmt Zeitstempel in die Protokolle auf. Standard: false

--follow

Streamt Protokolle in Echtzeit. Standard: false

--follow-interval INTEGER

Legt benutzerdefinierte Abfrageintervalle für das Protokoll-Streaming (–follow flag) in Sekunden fest. Standard: 2

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

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

  • Die aktuelle Rolle muss die Berechtigung MONITOR für den Dienst haben, um auf die Containerprotokolle zuzugreifen.

  • Die Funktion gibt ein Containerprotokoll als Zeichenfolge zurück.

  • Wenn Sie die Option --follow für Echtzeit-Protokoll-Streaming verwenden, werden die Optionen --num-lines und --previous-logs nicht unterstützt.

Beispiele

  • Das folgende Beispiel zeigt die letzten drei Zeilen des echo_service-Protokolls:

    snow spcs service logs echo_service --container-name echo --instance-id 0 --num-lines 3
    
    Copy
    10.18.94.31 - - [22/Nov/2024 09:16:47] "GET /healthcheck HTTP/1.1" 200 -
    10.18.94.31 - - [22/Nov/2024 09:16:52] "GET /healthcheck HTTP/1.1" 200 -
    10.18.94.31 - - [22/Nov/2024 09:16:57] "GET /healthcheck HTTP/1.1" 200 -
    
  • Dieses Beispiel streamt die Protokolle für den Dienst echo_service und aktualisiert sie alle 10 Sekunden:

    snow spcs service logs echo_service --container-name echo --instance-id 0 --follow --follow-interval 10
    
    Copy
  • Das folgende Beispiel zeigt die Protokolleinträge seit 09:30 UTC, 21. Nov. 2024:

    snow spcs service logs echo_service --container-name echo --instance-id 0 --since 2024-11-21T09:30:00Z
    
    Copy
  • Das folgende Beispiel ruft Protokolle aus dem zuletzt beendeten Container ab:

    snow spcs service logs example_job_service --container-name main --instance-id 0 --previous-logs
    
    Copy