Home / Golang / Command Line

ECS task event/log tracer CLI

tracer tracer is a tracing tool for Amazon ECS tasks. tracer shows events and logs of the tasks order by timestamp. Install $ brew install fujiwara/ta
Information
Category: Golang / Command Line
Watchers: 1
Star: 9
Fork: 0
Last update: Dec 1, 2021
Resource links
https://github.com/fujiwara/tracer

tracer

tracer is a tracing tool for Amazon ECS tasks.

tracer shows events and logs of the tasks order by timestamp.

Install

$ brew install fujiwara/tap/tracer

Binary Releases

Usage

usage: tracer <cluster> <task-id>

Environment variable AWS_REGION is required.

Example

Run a task successfully and shutdown.

$ tracer default 9f654c76cde14c7c85cf54dce087658a
2021-11-29T10:42:33.521+09:00	TASK	Created
2021-11-29T10:42:37.103+09:00	TASK	Connected
2021-11-29T10:42:48.298+09:00	TASK	Pull started
2021-11-29T10:42:55.473+09:00	TASK	Pull stopped
2021-11-29T10:42:56.374+09:00	CONTAINER:nginx	/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
2021-11-29T10:42:56.374+09:00	CONTAINER:nginx	/docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
2021-11-29T10:42:56.375+09:00	CONTAINER:nginx	/docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
2021-11-29T10:42:56.380+09:00	CONTAINER:nginx	10-listen-on-ipv6-by-default.sh: info: Getting the checksum of /etc/nginx/conf.d/default.conf
2021-11-29T10:42:56.418+09:00	TASK	Started
2021-11-29T10:42:56.446+09:00	CONTAINER:nginx	10-listen-on-ipv6-by-default.sh: info: Enabled listen on IPv6 in /etc/nginx/conf.d/default.conf
2021-11-29T10:42:56.446+09:00	CONTAINER:nginx	/docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
2021-11-29T10:42:56.448+09:00	CONTAINER:nginx	/docker-entrypoint.sh: Launching /docker-entrypoint.d/30-tune-worker-processes.sh
2021-11-29T10:42:56.449+09:00	CONTAINER:nginx	/docker-entrypoint.sh: Configuration complete; ready for start up
2021-11-29T10:42:56.452+09:00	CONTAINER:nginx	2021/11/29 01:42:56 [notice] 1#1: using the "epoll" event method
2021-11-29T10:42:56.452+09:00	CONTAINER:nginx	2021/11/29 01:42:56 [notice] 1#1: nginx/1.21.4
2021-11-29T10:42:56.452+09:00	CONTAINER:nginx	2021/11/29 01:42:56 [notice] 1#1: built by gcc 10.2.1 20210110 (Debian 10.2.1-6)
2021-11-29T10:42:56.452+09:00	CONTAINER:nginx	2021/11/29 01:42:56 [notice] 1#1: OS: Linux 4.14.248-189.473.amzn2.aarch64
2021-11-29T10:42:56.452+09:00	CONTAINER:nginx	2021/11/29 01:42:56 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1024:4096
2021-11-29T10:42:56.452+09:00	CONTAINER:nginx	2021/11/29 01:42:56 [notice] 1#1: start worker processes
2021-11-29T10:42:56.453+09:00	CONTAINER:nginx	2021/11/29 01:42:56 [notice] 1#1: start worker process 31
2021-11-29T10:42:56.453+09:00	CONTAINER:nginx	2021/11/29 01:42:56 [notice] 1#1: start worker process 32
2021-11-29T10:43:12.913+09:00	CONTAINER:nginx	10.3.3.10 - - [29/Nov/2021:01:43:12 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:43:42.898+09:00	CONTAINER:nginx	10.3.3.10 - - [29/Nov/2021:01:43:42 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:44:09.172+09:00	CONTAINER:nginx	10.3.1.178 - - [29/Nov/2021:01:44:09 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:44:12.929+09:00	CONTAINER:nginx	10.3.3.10 - - [29/Nov/2021:01:44:12 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:44:39.197+09:00	CONTAINER:nginx	10.3.1.178 - - [29/Nov/2021:01:44:39 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:44:42.960+09:00	CONTAINER:nginx	10.3.3.10 - - [29/Nov/2021:01:44:42 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:45:09.227+09:00	CONTAINER:nginx	10.3.1.178 - - [29/Nov/2021:01:45:09 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:45:12.966+09:00	CONTAINER:nginx	10.3.3.10 - - [29/Nov/2021:01:45:12 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:45:39.237+09:00	CONTAINER:nginx	10.3.1.178 - - [29/Nov/2021:01:45:39 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:45:42.973+09:00	CONTAINER:nginx	10.3.3.10 - - [29/Nov/2021:01:45:42 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:46:09.225+09:00	CONTAINER:nginx	10.3.1.178 - - [29/Nov/2021:01:46:09 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:46:13.004+09:00	CONTAINER:nginx	10.3.3.10 - - [29/Nov/2021:01:46:13 +0000] "GET / HTTP/1.1" 200 615 "-" "ELB-HealthChecker/2.0" "-"
2021-11-29T10:46:30.906+09:00	TASK	Stopping
2021-11-29T10:46:30.906+09:00	TASK	StoppedReason:Scaling activity initiated by (deployment ecs-svc/8709920613704280865)
2021-11-29T10:46:30.906+09:00	TASK	StoppedCode:ServiceSchedulerInitiated
2021-11-29T10:46:31.937+09:00	CONTAINER:nginx	2021/11/29 01:46:31 [notice] 1#1: signal 15 (SIGTERM) received, exiting
2021-11-29T10:46:31.938+09:00	CONTAINER:nginx	2021/11/29 01:46:31 [notice] 32#32: exiting
2021-11-29T10:46:31.938+09:00	CONTAINER:nginx	2021/11/29 01:46:31 [notice] 32#32: exit
2021-11-29T10:46:31.938+09:00	CONTAINER:nginx	2021/11/29 01:46:31 [notice] 31#31: exiting
2021-11-29T10:46:31.938+09:00	CONTAINER:nginx	2021/11/29 01:46:31 [notice] 31#31: exit
2021-11-29T10:46:31.988+09:00	CONTAINER:nginx	2021/11/29 01:46:31 [notice] 1#1: signal 14 (SIGALRM) received
2021-11-29T10:46:32.035+09:00	CONTAINER:nginx	2021/11/29 01:46:32 [notice] 1#1: signal 17 (SIGCHLD) received from 32
2021-11-29T10:46:32.035+09:00	CONTAINER:nginx	2021/11/29 01:46:32 [notice] 1#1: worker process 32 exited with code 0
2021-11-29T10:46:32.035+09:00	CONTAINER:nginx	2021/11/29 01:46:32 [notice] 1#1: signal 29 (SIGIO) received
2021-11-29T10:46:32.035+09:00	CONTAINER:nginx	2021/11/29 01:46:32 [notice] 1#1: signal 17 (SIGCHLD) received from 31
2021-11-29T10:46:32.035+09:00	CONTAINER:nginx	2021/11/29 01:46:32 [notice] 1#1: worker process 31 exited with code 0
2021-11-29T10:46:32.035+09:00	CONTAINER:nginx	2021/11/29 01:46:32 [notice] 1#1: exit
2021-11-29T10:46:43.234+09:00	TASK	Execution stopped
2021-11-29T10:47:06.292+09:00	TASK	Stopped
2021-11-29T10:47:06.292+09:00	CONTAINER:nginx	STOPPED (exit code: 0)

Failed to run task. (typo container image URL)

$ tracer default 9f654c76cde14c7c85cf54dce087658a
2021-11-27T02:29:15.055+09:00   TASK    Created
2021-11-27T02:29:33.527+09:00   TASK    Execution stopped
2021-11-27T02:29:43.569+09:00   TASK    Stopping
2021-11-27T02:29:43.569+09:00   TASK    StoppedReason:CannotPullContainerError: inspect image has been retried 1 time(s): failed to resolve ref "docker.io/library/ngin:latest": pull access denied, repository does not exist or may require authorization: server message: insufficient_scope: authorization failed
2021-11-27T02:29:43.569+09:00   TASK    StoppedCode:TaskFailedToStart
2021-11-27T02:29:57.070+09:00   TASK    Stopped

LICENSE

MIT

Author

fujiwara

0 Open More issues
Closed

remove ctx from struct.

null

opened Mar 24, 2022 by fujiwara 1
Closed

When executing from a lambda function, the SNS subject is too long when using ARNs

thank you great tool.

When executing from a lambda function, the SNS subject is too long when using ARNs

for example:

Tracer: arn:aws:ecs:ap-northeast-1:012345678901:task/dev-main/0123456789abcdef0123456789abcdef on arn:aws:ecs:ap-northeast-1:012345678901:cluster/main
2022-03-23T03:34:40.757Z	TASK	Created
2022-03-23T03:34:44.431Z	TASK	Connected
2022-03-23T03:34:58.254Z	TASK	Pull started
2022-03-23T03:35:18.965Z	TASK	Pull stopped
2022-03-23T03:35:37.090Z	TASK	Started
2022-03-23T03:41:15.397Z	TASK	Execution stopped
2022-03-23T03:41:25.441Z	TASK	Stopping
2022-03-23T03:41:25.441Z	TASK	StoppedReason:Essential container in task exited
2022-03-23T03:41:25.441Z	TASK	StoppedCode:EssentialContainerExited
2022-03-23T03:41:38.629Z	TASK	Stopped
2022-03-23T03:44:32.977Z	CONTAINER:hoge	LastStatus:STOPPED HealthStatus:UNKNOWN (exit code: 0)
2022-03-23T03:44:32.977Z	TASK	LastStatus:STOPPED
InvalidParameter: Invalid parameter: Subject

from aws cli help message:


       --subject (string)
          Optional parameter to be used as the "Subject" line when the message
          is  delivered  to email endpoints. This field will also be included,
          if present, in the standard JSON messages delivered  to  other  end-
          points.

          Constraints:  Subjects must be ASCII text that begins with a letter,
          number, or punctuation mark; must not include line breaks or control
          characters; and must be less than 100 characters long.

Sending SNS fails because the subject is too long. Therefore, we have made two changes.

  1. cluster name and task ID are extracted from ARN in the Lambda handler.
  2. if the Subject is longer than 100 characters, omit the end
opened Mar 23, 2022 by mashiike 1
Closed

Create the flag to display the version

About

It will be more helpful if the command provides a way to show the version of itself. To adjust the style as you prefer, I referred to the repositories below when writing code!

  • https://github.com/fujiwara/stretcher
  • https://github.com/kayac/ecspresso
opened Feb 14, 2022 by ebi-yade 1
Closed

show all status of containers and a task.

e.g.

2022-03-01T14:39:22.513+09:00   TASK    Stopped
2022-03-01T14:41:08.121+09:00   CONTAINER:web   LastStatus:STOPPED HealthStatus:UNKNOWN (exit code: 1)
2022-03-01T14:41:08.121+09:00   CONTAINER:nginx LastStatus:STOPPED HealthStatus:UNKNOWN
2022-03-01T14:41:08.121+09:00   CONTAINER:envoy LastStatus:STOPPED HealthStatus:UNKNOWN (exit code: 0) (reason: CannotInspectContainerError: Could not transition to inspecting; timed out after waiting 30s)
2022-03-01T14:41:08.121+09:00   TASK    LastStatus:STOPPED
opened Mar 1, 2022 by fujiwara 0
Closed

show all status of containers

task.StoppedAt is nil when task is not stopped.

opened Mar 1, 2022 by fujiwara 0
Closed

add -sns option

and refactoring...

opened Feb 16, 2022 by fujiwara 0

Contents

    yukiarrr CLI tool that you can interactively call Amazon ECS APIs (run-task, execute-command, stop-task), copy files between ECS and local, and view logs.
    aws-containers 🚀 Pre-flight checks for ECS Exec
    amethyst specs Entity-Component Systems (ECS) — Specs Parallel ECS
    minhealthnz Information about the technology and architecture of the NZ COVID Tracer app
    siddontang a golang log lib supports level and multi handlers
    adamschwartz Console.log with style.
    sadlil A Global event triggerer for golang. Defines functions as event with id string. Trigger the event anywhere from your project.
    JackieDo A log reader and management tool for Laravel
    amethyst specs — Specs Parallel ECS
    rileydakota AWS CDK/Cloudformation to deploy a Valheim Server using ECS Fargate!
    awsdocs The open source version of the Amazon ECS best practices guide. You can submit feedback & requests for changes by submitting issues in this repo or by making proposed changes & submitting a pull request.
    tedsmitt Provides an interactive prompt to connect to ECS Containers using the ECS ExecuteCommand API.
    rust-gamedev A suite of benchmarks designed to test and compare Rust ECS library performance across a variety of challenging circumstances.
    Aidan63 Everyone's making an ECS, so here's another one
    stillwwater C++ Entity Component System
    Nycto An ECS (entity component system) library for Nim
    zalando Best-of-breed OpenTracing utilities, instrumentations and extensions
    c-bata Yet another system call tracer written in Go.
    hi2p-perim A path tracer in 300 lines of C++
    mellinoe A C# ray tracer, capable of running on both the CPU and GPU.
    TheRealMJP A (very) simple path tracer implemented using DirectX Ray Tracing (DXR)
    Share this repo

    Related Repos


    Command Line
    24
    an easy to use terminal styling library
    iskaa02 Qalam ✏️ Qalam is a Go library for easy terminal styling. Installation go get github.com/iskaa02/qalam Usage func main(){ // this will output "a red
     
    Command Line
    6
    Experimental go cli tool to track your open issues and PRs.
    suadev git-sum cli tool See open issue and pull request counts for each repository of the user. Installation go install github.com/suadev/[email protected] Usa
     
    Command Line
    5
    2048, but for the terminal
    Bios-Marcel 2048 terminal edition This a simple 2048 implementation running on the terminal. 2048.mp4 Using To build, go version 1.17 or later is required. After
     
    Command Line
    3
    mirror is command line tool for mirroring a web page.
    yusukebe mirror mirror is command line tool for mirroring a web page. Caution Do not abuse Demo Installation go install github.com/yusukebe/mirror/cmd/[email protected]
     
    Command Line
    8
    A golang TUI implementation of the popular word quiz wordle!
    TheDonDope Gordle A golang TUI implementation of the popular word quiz Wordle! System requirements A system dictionary must be installed. On debian based systems
     
    Command Line
    8
    Lint CLI for languagetool.
    skanehira languagetool-lint Lint CLI for languagetool. Requirements languagetool. Installation $ go install github.com/skanehira/[email protected] Use as
     
    Command Line
    9
    CLI for Shopware Account
    FriendsOfShopware Shopware CLI A cli which contains handy helpful commands for daily Shopware tasks Features Manage your Shopware account extensions in the CLI Build an
     
    Command Line
    101
    mango is a man-page generator for the Go flag, pflag, and cobra packages
    muesli mango mango is a man-page generator for the Go flag, pflag, and cobra packages. It extracts commands, flags, and arguments from your program and enabl
     
    Command Line
    24
    From the command line, quickly explore data from a CSV file.
    tmickleydoyle shallow-explore From the command line, quickly explore data from a CSV file. shallow-explore is a Golang backed command-line tool for iterating over c
     
    Command Line
    3
    Branch is a small CLI tool to automatically create git branches based tickets
    MaikelVeen ________ ________ ________ ________ ________ ___ ___ |\ __ \ |\ __ \ |\ __ \ |\ ___ \ |\ ___
     
    Command Line
    9
    neovim plugin search from the terminal
    neurosnap nvim.sh neovim plugin directory search from the terminal $ curl https://nvim.sh/s/statusline Name Stars OpenIssues Updated
     
    Command Line
    15
    A better kubectl explain
    kei6u kubectl-explore This is a plugin for kubectl to fuzzy-find and explain the field supported API resource. What kubectl-explore finds and explains the f
     
    Command Line
    62
    CLI client for Portainer
    greenled Portainer Stack Utils Table of contents Overview Mission Vision Supported Portainer API How to install How to use Configuration Inline flags Environme
     
    Command Line
    77
    A lightweight CLI tool for versioning data alongside source code and building data pipelin...
    kevin-hanselman Dud Website | Install | Getting Started | Source Code Dud is a lightweight tool for versioning data alongside source code and building data pipelines.
     
    Command Line
    157
    The Symfony CLI tool
    symfony-cli The Symfony binary is a must-have tool when developing Symfony applications on your local machine. It provides: The best way to create new Symfony app