Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kanmu/ddcat
CLI to display Datadog Logs.
https://github.com/kanmu/ddcat
datadog golang
Last synced: 4 days ago
JSON representation
CLI to display Datadog Logs.
- Host: GitHub
- URL: https://github.com/kanmu/ddcat
- Owner: kanmu
- License: mit
- Created: 2023-07-26T07:51:19.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-07-01T17:59:51.000Z (6 months ago)
- Last Synced: 2024-11-05T09:46:19.563Z (about 2 months ago)
- Topics: datadog, golang
- Language: Go
- Homepage:
- Size: 55.7 KB
- Stars: 1
- Watchers: 15
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ddcat
[](https://github.com/kanmu/ddcat/actions/workflows/build.yml)
CLI to display Datadog Logs.
## Usage
```
Usage: ddcat --api-key=STRING --app-key=STRING
Arguments:
Search query. see https://docs.datadoghq.com/logs/explorer/search_syntax/
Flags:
-h, --help Show context-sensitive help.
--api-key=STRING Datadog API key ($DD_API_KEY).
--app-key=STRING Datadog APP key ($DD_APP_KEY).
--indexes=INDEXES,... Indexes to search.
--from=STRING The minimum time for the requested logs.
--to=STRING The maximum time for the requested logs.
--sort="timestamp" Sort parameters when querying logs ('timestamp', '-timestamp').
--with-attrs Include attributes in displayed logs.
--with-tags Include tags in displayed logs
--version
```
```
$ ddcat --from 'now-1m' '*'
{"timestamp":"2023-07-26T20:10:30+09:00","status":"info","service":"web","message":"GET /user/info 200 OK"}
{"timestamp":"2023-07-26T20:10:30+09:00","status":"error","service":"web","message":"POST /tag 400 Bad Request"}
{"timestamp":"2023-07-26T20:10:31+09:00","status":"info","service":"web","message":"POST /entry 200 OK"}
{"timestamp":"2023-07-26T20:10:32+09:00","status":"info","service":"web","message":"GET /entry 200 OK"}
...
$ ddcat --from 'now-1m' 'service:web status:info OK'
{"timestamp":"2023-07-26T20:10:30+09:00","status":"info","service":"web","message":"GET /user/info 200 OK"}
{"timestamp":"2023-07-26T20:10:31+09:00","status":"info","service":"web","message":"POST /entry 200 OK"}
{"timestamp":"2023-07-26T20:10:32+09:00","status":"info","service":"web","message":"GET /entry 200 OK"}
...
```
## Time settings
* Datadog syntax
* https://docs.datadoghq.com/logs/guide/access-your-log-data-programmatically/#time-settings
* [dateparse](https://github.com/araddon/dateparse) syntax
* https://github.com/araddon/dateparse#extended-example
* NOTE: [datepars.ParseLocal](https://pkg.go.dev/github.com/araddon/dateparse#ParseLocal) function is used inside ddcat.
## Related Links
* https://docs.datadoghq.com/logs/explorer/search_syntax/
* https://docs.datadoghq.com/logs/guide/access-your-log-data-programmatically/
* https://docs.datadoghq.com/api/latest/logs/#search-logs
## Installation
```
brew install kanmu/tools/ddcat
```