Download cw - Download de código fonte cw

cw

Outro código-fonte

v4.1.3

Baixar

cw

CW - A melhor maneira de fazer os logs da AWS Cloudwatch

A melhor maneira de fazer os logs do AWS CloudWatch do seu terminal.

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

Características
Instalação
Comandos e opções
Exemplos
Credenciais e configurações da AWS
Variado
Notas de liberação

Características

Sem dependências externas
- CW é um executável nativo direcionado ao seu sistema operacional. Sem pip, npm, rubygems.
Rápido .
- A CW está escrita em Golang e compilada contra sua arquitetura.
Analisador flexível de data e hora .
- Trabalhe com o fuso horário Local ou UTC (padrão).
- Análise flexível.
  - Formatos amigáveis humanos, ou seja, 2d1h20m para indicar 2 dias, 1 hora e 20 minutos atrás.
  - Uma hora específica, ou seja, 13:10 para indicar 13:10 de hoje.
  - Um registro de data e hora completo 2018-10-20T8:53 .
Grupos multi -logs de cauda
- Tail vários grupos de toras em paralelo: cw tail my-auth-service my-web .
Poderoso grep ( --grep ) e grepv ( --grepv ).
JMESPATH SUPPORTE PARA COGRIDADES JSON (MAIXO A AWS CLI --query
Operador de tubo suportado
- echo my-group | cw tail E cat groups.txt | cw tail .
Operador de redirecionamento >> suportado
- cw tail -f my-stream >> myfile.txt .
Saída colorida
- --no-color SPANG para desativar, se necessário.
Controle de credenciais flexíveis.
- Por padrão, os arquivos AWS .AWS/CREDENCIALS E .AWS/PERFIL são usados. As substituições podem ser alcançadas com os sinalizadores --profile e --region .

Instalação

Mac OSX

usando homebrew

brew tap lucagrulla/tap
brew install cw

Linux

usando LinuxBrew

brew tap lucagrulla/tap
brew install cw

.deb/.rpm

Faça o download da .deb ou .rpm na página Releases e instale com dpkg -i e rpm -i respectivamente.

Usando snapcraft.io

NOTA : Se você atualizar para 3.3.0, observe o novo comando Alias. Isso é necessário para cumprir as novas regras de liberação do Snapcraft.

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

cw funciona com confinamento rigoroso; A conexão de interface dot-aws-config-credentials é necessária para ter acesso a arquivos .aws/config e .aws/credentials

Nas janelas

usando scoop.sh

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

Ferramentas Go

go get github.com/lucagrulla/cw

Comandos e opções

Bandeiras globais

--profile=profile-name Substituir o perfil da AWS usado para conexão.
--region=aws-region Substitua a região do AWS alvo.
--no-color Desativar saída colorida.
--endpoint O alvo AWS Endpoint URL. Por padrão, a CW usará os pontos de extremidade padrão da AWS.
--no-version-check Ignore Verifica se uma versão mais recente do módulo está disponível.

Comandos

cw ls Listar todos os grupos de log/fluxos de log dentro de um 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 um determinado grupo de log/fluxo de log

 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.

Exemplos

Lista dos grupos de toras disponíveis
- cw ls groups
Lista dos fluxos de log em um determinado grupo de log
- cw ls streams my-log-group
cauda e siga os grupos/fluxos de toras
- 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 começar de 7 dias atrás.
- cw tail -f my-log-group:my-log-stream-prefix -b3h para começar de 3 horas atrás.
- cw tail -f my-log-group:my-log-stream-prefix -b100m para começar a partir de 100 minutos atrás.
- cw tail -f my-log-group:my-log-stream-prefix -b2h30m para começar de 2 horas e 30 minutos atrás.
- cw tail -f my-log-group -b9:00 -e9:01
Loges de consulta JSON usando sintaxe jMespath
- cw tail -f my-log-group --query "machines[?state=='running'].name"

Tempo e datas

Tempo e datas são tratados como UTC por padrão. Use o sinalizador --local se preferir usar a zona local.

Credenciais e configurações da AWS

cw usa o perfil de credenciais padrão (armazenado em ./aws/credentials) para autenticação e configuração compartilhada (.aws/config) para identificar a região AWS de destino. O perfil e a região são superestáveis através do profile e region , bandeiras globais.

AWS SSO

AWS SSO é suportado se você:

Use um perfil da CLI ( default ou um perfil nomeado alternativo) que inclui as várias propriedades do SSO
- sso_start_url , sso_account_id , sso_role_name , etc
Tenha uma sessão SSO válida e ativa
- via aws sso login

Se você receber uma mensagem de erro que inclui ...failed to sign request: failed to retrieve credentials: the SSO session has expired or is invalid... então você deve renovar sua sessão SSO via aws sso login (e especificar o perfil nomeado, se apropriado).