Skip to content

Commit

Permalink
pes
Browse files Browse the repository at this point in the history
  • Loading branch information
klaxalk committed Nov 29, 2024
1 parent 6943d7c commit 3419793
Show file tree
Hide file tree
Showing 2 changed files with 38 additions and 2 deletions.
36 changes: 36 additions & 0 deletions docs/10-prerequisities/30-docker/50-logging.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,3 +5,39 @@ description: How log containers' stdout and stderr
---

# Logging containers' output

Logging of the `stdout` and `stderr` can be facilitated using Docker's logging adapters.
However, using logging adapters is relatively complex and requires additional user's knowledge for extraction of the logs.
For that reason, we are utilizing a custom solution that requires zero configuration and minimal knowledge.

# [DogTail](https://github.com/klaxalk/dogtail)

**DoGTail** (**Docker Go Tail**) is a lightweight, zero-configuration logging sidecar Docker Compose.
It automatically **tails** the **stdout** and **stderr** streams from all containers in a Compose session, storing them in organized, plaintext log files for easy access.

Please follow to the official DogTail repository to learn more about it:
<Button label="πŸ”— klaxalk/dogtail repository" link="https://github.com/klaxalk/dogtail" block /><br />

## Example usecase

The following `compose` files shows how to load DogTail into a compose session.
The resulting logs will be stored in the `logs` volume and accesible via [Portainer](/docs/prerequisities/portainer).

```yaml
volumes:

logs:

services:

myapp:
image: your-image
tty: true # this ensures the stdout and stderr are ordered properly in the logs
# your app configuration here

dogtail:
image: klaxalk/dogtail:latest
volumes:
- /var/run/docker.sock:/var/run/docker.sock
- logs:/etc/logs:consistent
```
4 changes: 2 additions & 2 deletions docs/50-features/70-libraries/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,9 +11,9 @@ description: MRS C++ libraries
The `mrs_lib` is a set of various utility libraries that are designed to make your life easier when working with ROS and contains implementations of common robotic algorithms, such as the Kalman Filter and its variants.
For a more comprehensive list of what is offered and how to use it, see the documentation.

<Button label="πŸ”— mrs_lib repository" link="https://github.com/ctu-mrs/mrs_lib" block /><br />
<Button label="πŸ”— ctu-mrs/mrs_lib repository" link="https://github.com/ctu-mrs/mrs_lib" block /><br />

<Button label="πŸ”— mrs_lib documentation" link="https://ctu-mrs.github.io/mrs_lib/" block /><br />
<Button label="πŸ”— ctu-mrs/mrs_lib documentation" link="https://ctu-mrs.github.io/mrs_lib/" block /><br />

## Notable libraries:

Expand Down

0 comments on commit 3419793

Please sign in to comment.