Descargar cw - Descargar código fuente de cw

cw

Otro código fuente

v4.1.3

Descargar

CW

CW - La mejor manera de Tail AWS CloudWatch Logs

La mejor manera de colocar registros de AWS CloudWatch desde su terminal.

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

Características
Instalación
Comandos y opciones
Ejemplos
Credenciales y configuración de AWS
Misceláneas
Notas de lanzamiento

Características

Sin dependencias externas
- CW es un ejecutable nativo dirigido a su sistema operativo. No Pip, NPM, Rubygems.
Rápido .
- CW está escrito en Golang y compilado contra su arquitectura.
Parser de fecha y hora flexible .
- Trabaje con la zona horaria Local o UTC (predeterminado).
- Análisis flexible.
  - Formatos amigables para humanos, es decir, 2d1h20m para indicar 2 días, 1 hora y 20 minutos.
  - Una hora específica, es decir, 13:10 para indicar 13:10 de hoy.
  - Una marca de tiempo completa 2018-10-20T8:53 .
Cola de grupos de múltiples troncos
- cola múltiples grupos de registro en paralelo: cw tail my-auth-service my-web .
Potente GREP incorporado ( --grep ) y GREPV ( --grepv ).
JMESPATH Soporte para consultas JSON (que coincide con la bandera AWS CLI --query )
Operador de tubería soportado
- echo my-group | cw tail Grupos echo my-group | cw tail and cat groups.txt | cw tail .
Operador de redirección >> compatible
- cw tail -f my-stream >> myfile.txt .
Salida de color
- -Bandera --no-color para deshabilitar si es necesario.
Control de credenciales flexibles.
- Por defecto, se utilizan los archivos AWS .AWS/Credentials y .AWS/Perfil . Las anulaciones se pueden lograr con las banderas --profile y --region .

Instalación

Mac OSX

Usando Homebrew

brew tap lucagrulla/tap
brew install cw

Linux

Usando LinuxBrew

brew tap lucagrulla/tap
brew install cw

.deb/.rpm

Descargue el .deb o .rpm de la página de versiones e instale con dpkg -i y rpm -i respectivamente.

Usando snapcraft.io

Nota : Si se actualiza a 3.3.0, tenga en cuenta el comando nuevo alias. Esto se requiere para cumplir con las nuevas reglas de lanzamiento de Snapcraft.

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

cw corre con confinamiento estricto; Se requiere la conexión de la interfaz dot-aws-config-credentials para tener acceso a archivos .aws/config y .aws/credentials

En Windows

Usando scoop.sh

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

GO Herramientas

go get github.com/lucagrulla/cw

Comandos y opciones

Banderas globales

--profile=profile-name anular el perfil de AWS utilizado para la conexión.
--region=aws-region anular la región de AWS objetivo.
--no-color desactive la salida de color.
--endpoint La URL de punto final AWS de Target. Por defecto, CW usará los puntos finales AWS predeterminados.
--no-version-check Ignore Checks si hay una versión más nueva del módulo disponible.

Comandos

cw ls Lista Todos los grupos de registro/transmisiones de registro dentro de un grupo

 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 Tail Un grupo de registro/transmisión de registro determinado

 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.

Ejemplos

Lista de los grupos de registro disponibles
- cw ls groups
Lista de las transmisiones de registro en un grupo de registro determinado
- cw ls streams my-log-group
Tail y siga grupos de registro dados/transmisiones
- 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 para comenzar desde hace 7 días.
- cw tail -f my-log-group:my-log-stream-prefix -b3h para comenzar desde hace 3 horas.
- cw tail -f my-log-group:my-log-stream-prefix -b100m para comenzar desde hace 100 minutos.
- cw tail -f my-log-group:my-log-stream-prefix -b2h30m para comenzar desde hace 2 horas y 30 minutos.
- cw tail -f my-log-group -b9:00 -e9:01
consulta registros de json usando sintaxis jmespath
- cw tail -f my-log-group --query "machines[?state=='running'].name"

Tiempo y fechas

El tiempo y las fechas se tratan como UTC de forma predeterminada. Use la bandera --local si prefiere usar la zona local.

Credenciales y configuración de AWS

cw utiliza el perfil de credenciales predeterminado (almacenado en ./AWS/Credentials) para la autenticación y la configuración compartida (.aws/config) para identificar la región AWS de destino. Tanto el perfil como la región son anulables a través del profile y las banderas globales region .

AWS SSO

AWS SSO es compatible si:

Use un perfil CLI (ya sea default o un perfil con nombre alternativo) que incluye las diversas propiedades SSO
- sso_start_url , sso_account_id , sso_role_name , etc
tener una sesión SSO válida y activa
- a través de aws sso login

Si recibe un mensaje de error que incluye ...failed to sign request: failed to retrieve credentials: the SSO session has expired or is invalid... entonces debe renovar su sesión SSO a través aws sso login (y especificar el perfil con nombre, si corresponde).