docker-logql

module

v0.0.0-...-757bced Latest Latest Go to latest Published: Aug 16, 2024 License: Apache-2.0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/tdakkota/docker-logql

Links

Open Source Insights

README ¶

docker-logql

A simple Docker CLI plugin to run LogQL queries over docker container logs.

Installation

Build docker-logql binary.
- NOTE: docker- prefix is important, docker would not find plugin without it.
Add binary to plugin directory
- ~/.docker/cli-plugins for current user
- /usr/local/libexec/docker/cli-plugins for system-wide installation

Or use make install, it would build and add plugin to ~/.docker/cli-plugins directory.

git clone https://github.com/tdakkota/docker-logql
cd docker-logql
make install

Query logs

$ docker logql query --help

Usage:  docker logql query <logql>

Examples:
# Get logs from all containers.
docker logql query '{}'

# Get logs for last 24h from container "registry" that contains "info".
docker logql query --since=1d '{container="registry"} |= "info"'

Options:
      --color                             Enable color (default true)
  -c, --container                         Show container name (default true)
      --end lokiapi.LokiTime              End of query range
      --limit int                         Limit result (default -1)
      --since start                       A duration used to calculate start relative to `end`
      --start lokiapi.LokiTime            Start of query range
      --step lokiapi.PrometheusDuration   Query resolution step
  -t, --timestamp                         Show timestamps (default true)

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
cmd
docker-logql Command main implements Docker CLI plugin to run LogQL queries.	Command main implements Docker CLI plugin to run LogQL queries.
internal
cliversion Package cliversion provides the version of the binary.	Package cliversion provides the version of the binary.
dockerlog Package dockerlog provides Docker container log parser.	Package dockerlog provides Docker container log parser.
iterators Package iterators define storage iterator interfaces and some utilities.	Package iterators define storage iterator interfaces and some utilities.
lexerql Package lexerql provides utilities for lexing in *QL languages.	Package lexerql provides utilities for lexing in *QL languages.
logql Package logql contains LogQL parser and AST definitions.	Package logql contains LogQL parser and AST definitions.
logql/lexer Package lexer contains LogQL lexer.	Package lexer contains LogQL lexer.
logql/logqlengine Package logqlengine implements LogQL evaluation engine.	Package logqlengine implements LogQL evaluation engine.
logql/logqlengine/jsonexpr Package jsonexpr provides JSON extractor expression parser.	Package jsonexpr provides JSON extractor expression parser.
logql/logqlengine/logqlmetric Package logqlmetric provides metric queries implementation.	Package logqlmetric provides metric queries implementation.
logql/logqlengine/logqlpattern Package logqlpattern contains parser for LogQL `pattern` stage pattern.	Package logqlpattern contains parser for LogQL `pattern` stage pattern.
logstorage Package logstorage defines storage structure for logs storage.	Package logstorage defines storage structure for logs storage.
lokiapi Code generated by ogen, DO NOT EDIT.	Code generated by ogen, DO NOT EDIT.
otelstorage Package otelstorage contains common types and utilities for storing OpenTelemetry data.	Package otelstorage contains common types and utilities for storing OpenTelemetry data.