Server Logs

The following section documents settings for configuring AIStor to publish minio server logs to an HTTP webhook endpoint. See Publish Server Logs to HTTP Webhook for more complete documentation and tutorials on using these settings.

Example

Environment Variables

You can specify multiple webhook endpoints as log targets by appending a unique identifier _ID for each set of related logging environment variables. For example, the following settings define two distinct server log webhook endpoints:

export MINIO_LOGGER_WEBHOOK_ENABLE_PRIMARY="on"
export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_PRIMARY="TOKEN"
export MINIO_LOGGER_WEBHOOK_ENDPOINT_PRIMARY="http://webhook-1.example.net"

export MINIO_LOGGER_WEBHOOK_ENABLE_SECONDARY="on"
export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_SECONDARY="TOKEN"
export MINIO_LOGGER_WEBHOOK_ENDPOINT_SECONDARY="http://webhook-2.example.net"

Configuration Setting

You can specify multiple webhook endpoints as log targets by appending a unique identifier _ID to the configuration key. For example, the following settings define two distinct endpoints:

mc admin config set logger_webhook:primary \
   endpoint="http://webhook-01.example.net" [ARGUMENTS=VALUE ...]

mc admin config set logger_webhook:secondary \
   endpoint="http://webhook-02.example.net" [ARGUMENTS=VALUE ...]

Settings

Enable

Environment Variable Configuration Setting

Specify “on” to enable publishing minio server logs to the HTTP webhook endpoint. Requires specifying MINIO_LOGGER_WEBHOOK_ENDPOINT.

Webhook Endpoint

Environment Variable Configuration Setting

The HTTP endpoint of the webhook.

Authentication Token

Environment Variable Configuration Setting

An authentication token of the appropriate type for the endpoint. Omit for endpoints which do not require authentication. To allow for a variety of token types, AIStor creates the request authentication header using the value exactly as specified. Depending on the endpoint, you may need to include additional information.

For example: for a Bearer token, prepend Bearer:

export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_myendpoint="Bearer 1a2b3c4f5e"

Modify the value according to the endpoint requirements. A custom authentication format could resemble the following:

export MINIO_LOGGER_WEBHOOK_AUTH_TOKEN_xyz="ServiceXYZ 1a2b3c4f5e"

Consult the documentation for the desired service for more details.

Batch Size

Environment Variable Configuration Setting

Collect and send the specified number of events to the webhook as a batch. If not set, AIStor sends one event per request.

Client Certificate

Environment Variable Configuration Setting

The path to the mTLS certificate to use for authenticating to the webhook logger.

Client Key

Environment Variable Configuration Setting

The path to the mTLS certificate key to use to authenticate with the webhook logger service.

Webhook Proxy

Environment Variable Configuration Setting

Define a proxy to use for the webhook logger when communicating from AIStor to external webhooks.

Queue Dir

Environment Variable Configuration Setting

Specify the directory path, such as /opt/minio/events, to enable MinIO’s persistent event store for undelivered messages. The AIStor process must have read, write, and list access on the specified directory. AIStor stores undelivered events in the specified store while the webhook service is offline and replays the stored events when connectivity resumes.

Queue Size

Environment Variable Configuration Setting

An integer value to use for the queue size for logger webhook targets.