Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create logentries.md #244

Merged
merged 4 commits into from
Nov 16, 2016
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions _data/toc.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -153,6 +153,8 @@ toc:
title: Configuring Logging Drivers
- path: /engine/admin/logging/log_tags/
title: Log tags for logging driver
- path: engine/admin/logging/logentries/
title: Logentries logging driver
- path: /engine/admin/logging/awslogs/
title: Amazon CloudWatch Logs logging driver
- path: /engine/admin/logging/etwlogs/
Expand Down
48 changes: 48 additions & 0 deletions engine/admin/logging/logentries.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
title: Logentries logging driver
description: Describes how to use the logentries logging driver.
keywords: logentries, docker, logging, driver
---

The `logentries` logging driver sends container logs to the
[Logentries](https://logentries.com/) server.

## Usage

Some options are supported by specifying `--log-opt` as many times as needed:

- `logentries-token`: specify the logentries log set token

Configure the default logging driver by passing the
`--log-driver` option to the Docker daemon:

```bash
$ dockerd --log-driver=logentries
```

To set the logging driver for a specific container, pass the
`--log-driver` option to `docker run`:

```bash
$ docker run --log-driver=logentries ...
```

Before using this logging driver, you'll need to create a new Log Set in the
Logentries web interface. Then, you'll need to pass the token of that log set
to Docker:

```bash
$ docker run --log-driver=logentries --log-opt logentries-token=abcd1234-12ab-34cd-5678-0123456789ab
```

## Options

Users can use the `--log-opt NAME=VALUE` flag to specify additional Logentries logging driver options.

### logentries-token

You need to provide your log set token for logentries driver to work:

```bash
$ docker run --log-driver=logentries --log-opt logentries-token=abcd1234-12ab-34cd-5678-0123456789ab
```