Startseite>Programmierbezogen>Anderer Quellcode
Herunterladen

CW

CW - Der beste Weg, AWS -CloudWatch -Protokolle zu beenden

Der beste Weg, AWS -CloudWatch -Protokolle aus Ihrem Terminal zu verhindern.

Autor - Luca Grulla - https://www.lucagrulla.com

  • Merkmale
  • Installation
  • Befehle und Optionen
  • Beispiele
  • AWS -Anmeldeinformationen und Konfiguration
  • Verschiedenes
  • Versionshinweise

Merkmale

  • Keine externen Abhängigkeiten
    • CW ist eine native ausführbare Datei, die auf Ihr Betriebssystem abzielt. Keine PIP, NPM, Rubygemems.
  • Schnell .
    • CW ist in Golang geschrieben und gegen Ihre Architektur zusammengestellt.
  • Flexibler Datum und Uhrzeit -Parser .
    • Arbeiten Sie entweder mit Local Zeitzone oder UTC (Standard).
    • Flexible Parsen.
      • Menschliche freundliche Formate, dh 2d1h20m , um vor 2 Tagen, 1 Stunde und 20 Minuten anzuzeigen.
      • Eine bestimmte Stunde, dh 13:10 , um 13:10 heute anzuzeigen.
      • Ein vollständiger Zeitstempel 2018-10-20T8:53 .
  • Multi -Log -Gruppen Tailing
    • Schwanz mehrere logarithmische Gruppen parallel: cw tail my-auth-service my-web .
  • Leistungsstarke eingebaute Grep ( --grep ) und Grepv ( --grepv ).
  • JMespath -Unterstützung für JSON -Abfragen (entspricht der AWS CLI --query -Flagge)
  • Rohroperator unterstützt
    • echo my-group | cw tail und cat groups.txt | cw tail .
  • Umleitungsoperator >> unterstützt
    • cw tail -f my-stream >> myfile.txt .
  • Farbige Ausgabe
    • --no-color Flag, um bei Bedarf zu deaktivieren.
  • Flexible Anmeldeinformationen Kontrolle.
    • Standardmäßig werden die AWS .AWs/Anmeldeinformationen und .AWs/Profildateien verwendet. Überschreibungen können mit den Fahnen --profile und --region -Flaggen erreicht werden.

Installation

Mac OSX

mit Homebrew 

brew tap lucagrulla/tap
brew install cw

Linux

mit LinuxBrew 

brew tap lucagrulla/tap
brew install cw

.deb/.rpm

Laden Sie die .deb oder .rpm von der Releases -Seite herunter und installieren Sie sie mit dpkg -i bzw. rpm -i .

mit snapcraft.io

Hinweis : Wenn Sie auf 3.3.0 upgraden, beachten Sie bitte den neuen Alias ​​-Befehl. Dies ist erforderlich, um die neuen Release -Regeln von Snapcraft zu erfüllen. 

snap install cw-sh
sudo snap connect cw-sh:dot-aws-config-credentials
sudo snap alias cw-sh.cw cw

cw läuft mit strikter Einschränkung; Die Schnittstelle zwischen dot-aws-config-credentials muss zu Zugriff auf .aws/config und .aws/credentials -Dateien erforderlich sind

Unter Windows

mit Scoop.sh 

scoop bucket add cw https://github.com/lucagrulla/cw-scoop-bucket.git
scoop install cw

Gehen Sie Werkzeuge 

go get github.com/lucagrulla/cw

Befehle und Optionen

Globale Flaggen

  • --profile=profile-name Überschreiben Sie das für die Verbindung verwendete AWS-Profil.
  • --region=aws-region überschreiben die Ziel-AWS-Region.
  • --no-color Deaktivieren Sie die farbige Ausgabe.
  • --endpoint Die Ziel-AWS-Endpunkt-URL. Standardmäßig verwendet CW die Standard -AWS -Endpunkte.
  • --no-version-check ignorieren Sie Überprüfungen, wenn eine neuere Version des Moduls verfügbar ist.

Befehle

  • cw ls Listen Sie alle Protokollgruppen/Protokollströme in einer Gruppe auf 

     Usage: cw ls <command>

show an entity

Flags:
  -h, --help               Show context-sensitive help.
      --endpoint=URL       The target AWS endpoint url. By default cw will use the default aws endpoints. NOTE: v4.0.0
                          dropped the flag short version.
      --profile=PROFILE    The target AWS profile. By default cw will use the default profile defined in the
                          .aws/credentials file. NOTE: v4.0.0 dropped the flag short version.
      --region=REGION      The target AWS region. By default cw will use the default region defined in the
                          .aws/credentials file. NOTE: v4.0.0 dropped the flag short version.
      --no-color           Disable coloured output.NOTE: v4.0.0 dropped the flag short version.
      --version            Print version information and quit
      --no-version-check   Ignore checks if a newer version of the module is available.

Commands:
  ls groups
    Show all groups.

  ls streams <group>
    Show all streams in a given log group.

cw: error: expected one of "groups",  "streams"

  • cw tail Schwanz Ein bestimmter Protokollgruppe/Protokollstrom 

     Usage: cw tail <groupName[:logStreamPrefix]> ...

Tail log groups/streams.

Arguments:
  <groupName[:logStreamPrefix]> ...    The log group and stream name, with group:prefix syntax. Stream name can be just the prefix. If no stream name is specified all stream names in the given
                                      group will be tailed. Multiple group/stream tuple can be passed. e.g. cw tail group1:prefix1 group2:prefix2 group3:prefix3.

Flags:
  -h, --help                           Show context-sensitive help.
      --endpoint=URL                   The target AWS endpoint url. By default cw will use the default aws endpoints. NOTE: v4.0.0 dropped the flag short version.
      --profile=PROFILE                The target AWS profile. By default cw will use the default profile defined in the .aws/credentials file. NOTE: v4.0.0 dropped the flag short version.
      --region=REGION                  The target AWS region. By default cw will use the default region defined in the .aws/credentials file. NOTE: v4.0.0 dropped the flag short version.
      --no-color                       Disable coloured output.NOTE: v4.0.0 dropped the flag short version.
      --version                        Print version information and quit
      --no-version-check               Ignore checks if a newer version of the module is available.

  -f, --follow                         Don't stop when the end of streams is reached, but rather wait for additional data to be appended.
  -t, --timestamp                      Print the event timestamp.
  -i, --event-id                       Print the event Id.
  -s, --stream-name                    Print the log stream name this event belongs to.
  -n, --group-name                     Print the log group name this event belongs to.
  -r, --retry                          Keep trying to open a log group/log stream if it is inaccessible.
  -b, --start="2021-04-11T08:21:52"    The UTC start time. Passed as either date/time or human-friendly format. The human-friendly format accepts the number of days, hours and minutes prior to
                                      the present. Denote days with 'd', hours with 'h' and minutes with 'm' i.e. 80m, 4h30m, 2d4h. If just time is used (format: hh[:mm]) it is expanded to
                                      today at the given time. Full available date/time format: 2017-02-27[T09[:00[:00]].
  -e, --end=STRING                     The UTC end time. Passed as either date/time or human-friendly format. The human-friendly format accepts the number of days, hours and minutes prior to the
                                      present. Denote days with 'd', hours with 'h' and minutes with 'm' i.e. 80m, 4h30m, 2d4h. If just time is used (format: hh[:mm]) it is expanded to today at
                                      the given time. Full available date/time format: 2017-02-27[T09[:00[:00]].
  -l, --local                          Treat date and time in Local timezone.
  -g, --grep=STRING                    Pattern to filter logs by. See http://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html for syntax.
  -v, --grepv=STRING                   Equivalent of grep --invert-match. Invert match pattern to filter logs by.
  -q, --query=STRING                   Equivalent of the --query flag in AWS CLI. Takes a JMESPath expression to filter JSON logs by. If the query fails (e.g. the log message was not JSON) then the original line is returned.

Beispiele

  • Liste der verfügbaren Protokollgruppen

    • cw ls groups

  • Liste der Protokollströme in einer bestimmten Protokollgruppe

    • cw ls streams my-log-group

  • Schwanz und folgen angegebenen Protokollgruppen/Streams

    • cw tail -f my-log-group
    • cw tail -f my-log-group:my-log-stream-prefix
    • cw tail -f my-log-group:my-log-stream-prefix my-log-group2
    • cw tail -f my-log-group:my-log-stream-prefix -b2017-01-01T08:10:10 -e2017-01-01T08:05:00
    • cw tail -f my-log-group:my-log-stream-prefix -b7d von vor 7 Tagen.
    • cw tail -f my-log-group:my-log-stream-prefix -b3h von vor 3 Stunden.
    • cw tail -f my-log-group:my-log-stream-prefix -b100m um vor 100 Minuten zu beginnen.
    • cw tail -f my-log-group:my-log-stream-prefix -b2h30m um vor 2 Stunden und 30 Minuten zu beginnen.
    • cw tail -f my-log-group -b9:00 -e9:01

  • Abfragen Sie JSON -Protokolle mit JMespath -Syntax

    • cw tail -f my-log-group --query "machines[?state=='running'].name"

Zeit und Daten

Zeit und Daten werden standardmäßig als UTC behandelt. Verwenden Sie das --local Flag, wenn Sie es vorziehen, die lokale Zone zu verwenden.

AWS -Anmeldeinformationen und Konfiguration

cw verwendet das Standard -Anmeldeinformationenprofil (gespeichert in ./aws/credentials) für die Authentifizierung und gemeinsame Konfiguration (.aws/config) zur Identifizierung des Ziel -AWS -Bereichs. Sowohl das Profil als auch die Region sind über das profile und die globalen Flaggen region überschrieben.

AWS SSO

AWS SSO wird unterstützt, wenn Sie:

  • Verwenden Sie ein CLI -Profil (entweder default oder ein alternatives benanntes Profil), das die verschiedenen SSO -Eigenschaften enthält
    • sso_start_url , sso_account_id , sso_role_name usw.
  • eine gültige aktive SSO -Sitzung haben
    • Via aws sso login

Wenn Sie eine Fehlermeldung erhalten, die ...failed to sign request: failed to retrieve credentials: the SSO session has expired or is invalid... Dann sollten Sie Ihre SSO -Sitzung über aws sso login verlängern (und gegebenenfalls das benannte Profil angeben).

Verschiedenes

Verwenden Sie cw hinter einem Proxy

Bitte verwenden Sie die variable HTTP_PROXY Umgebungsvariable, wie dies von AWS CLI: https://docs.aws.amazon.com/cli/Latest/userguide/cli-configure-proxy.html erforderlich ist

Veränderungsnotizen

Lesen Sie hier

Expandieren
Zusätzliche Informationen
Ähnliche Anwendungen
Empfohlen für Sie
Ähnliche Nachrichten Alle