engine: remove logentries logging driver

The logentries logging driver was removed in Docker Engine v25. The logentries
service was already shut-down, so it's unlikely there's still active users of
this driver.

When upgrading to Docker Engine v25, any container configured with this driver
will automatically be migrated to the "local" logging driver, so no action
is required from the user, and we can safely remove these docs.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
This commit is contained in:
Sebastiaan van Stijn 2024-01-19 22:50:11 +01:00
parent 672ff038b8
commit db4b38af58
No known key found for this signature in database
GPG Key ID: 76698F39D527CE8C
3 changed files with 2 additions and 73 deletions

View File

@ -3,9 +3,11 @@ description: Learn how to configure logging driver for the Docker daemon
keywords: docker, logging, driver
title: Configure logging drivers
aliases:
- /config/containers/logging/logentries/
- /engine/reference/logging/overview/
- /engine/reference/logging/
- /engine/admin/reference/logging/
- /engine/admin/logging/logentries/
- /engine/admin/logging/overview/
---
@ -196,7 +198,6 @@ see more options.
| [`splunk`](splunk.md) | Writes log messages to `splunk` using the HTTP Event Collector. |
| [`etwlogs`](etwlogs.md) | Writes log messages as Event Tracing for Windows (ETW) events. Only available on Windows platforms. |
| [`gcplogs`](gcplogs.md) | Writes log messages to Google Cloud Platform (GCP) Logging. |
| [`logentries`](logentries.md) ([deprecated](../../../../engine/deprecated.md#logentries-logging-driver)) | Writes log messages to Rapid7 Logentries. |
## Limitations of logging drivers

View File

@ -1,70 +0,0 @@
---
title: Logentries logging driver (deprecated)
description: Learn how to use the logentries logging driver with Docker Engine
keywords: logentries, docker, logging, driver
aliases:
- /engine/admin/logging/logentries/
---
> **Deprecated**
>
> The logentries service is no longer in operation since November 15, 2022,
> and the logentries driver [has been deprecated](../../../engine/deprecated.md#logentries-logging-driver).
>
> This driver will be removed in Docker Engine v25.0, and you must migrate to
> a supported logging driver before upgrading to Docker Engine v25.0. Read the
> [Configure logging drivers](configure.md) page for an overview of supported
> logging drivers.
{ .warning }
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
- `line-only`: send raw payload only
Configure the default logging driver by passing the
`--log-driver` option to the Docker daemon:
```console
$ dockerd --log-driver=logentries
```
To set the logging driver for a specific container, pass the
`--log-driver` option to `docker run`:
```console
$ docker run --log-driver=logentries ...
```
Before using this logging driver, you need to create a new Log Set in the
Logentries web interface and pass the token of that log set to Docker:
```console
$ 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 the Logentries driver to work:
```console
$ docker run --log-driver=logentries --log-opt logentries-token=abcd1234-12ab-34cd-5678-0123456789ab
```
### line-only
You could specify whether to send log message wrapped into container data (default) or to send raw log line
```console
$ docker run --log-driver=logentries --log-opt logentries-token=abcd1234-12ab-34cd-5678-0123456789ab --log-opt line-only=true
```

View File

@ -1543,8 +1543,6 @@ Manuals:
section:
- path: /config/containers/logging/local/
title: Local file logging driver
- path: /config/containers/logging/logentries/
title: Logentries logging driver
- path: /config/containers/logging/json-file/
title: JSON File logging driver
- path: /config/containers/logging/gelf/