Loggly Configuration

Configuration

This plugin is compatible with DB-less mode.

Compatible protocols

The Loggly plugin is compatible with the following protocols:

grpc, grpcs, http, https, tcp, tls, tls_passthrough, udp, ws, wss

Parameters

Here's a list of all the parameters which can be used in this plugin's configuration:

• name

  string required

  The name of the plugin, in this case loggly.

• instance_name

  string

  An optional custom name to identify an instance of the plugin, for example loggly_my-service. Useful when running the same plugin in multiple contexts, for example, on multiple services.

• service.name or service.id

  string

  The name or ID of the service the plugin targets. Set one of these parameters if adding the plugin to a service through the top-level /plugins endpoint. Not required if using /services/SERVICE_NAME|SERVICE_ID/plugins.

• route.name or route.id

  string

  The name or ID of the route the plugin targets. Set one of these parameters if adding the plugin to a route through the top-level /plugins endpoint. Not required if using /routes/ROUTE_NAME|ROUTE_ID/plugins.

• consumer.name or consumer.id

  string

  The name or ID of the consumer the plugin targets. Set one of these parameters if adding the plugin to a consumer through the top-level /plugins endpoint. Not required if using /consumers/CONSUMER_NAME|CONSUMER_ID/plugins.

• enabled

  boolean default: true

  Whether this plugin will be applied.

• config

  record required
  • host

    string default: logs-01.loggly.com

    The IP address or hostname of Loggly server.

  • port

    integer default: 514 between: 0 65535

    The UDP port to send data to on the Loggly server.

  • key

    string required referenceable encrypted

    Loggly customer token.

  • tags

    set of type string default: kong

    An optional list of tags to support segmentation and filtering of logs.

  • log_level

    string default: info Must be one of: debug, info, notice, warning, err, crit, alert, emerg

    An optional logging severity, any request with equal or higher severity will be logged to Loggly. Available options: debug, info, notice, warning, err, crit, alert, emerg.

  • successful_severity

    string default: info Must be one of: debug, info, notice, warning, err, crit, alert, emerg

    An optional logging severity assigned to all the successful requests with a response status code 400. Available options: debug, info, notice, warning, err, crit, alert, emerg.

  • client_errors_severity

    string default: info Must be one of: debug, info, notice, warning, err, crit, alert, emerg

    An optional logging severity assigned to all the failed requests with a response status code 400 or higher but less than 500. Available options: debug, info, notice, warning, err, crit, alert, emerg.

  • server_errors_severity

    string default: info Must be one of: debug, info, notice, warning, err, crit, alert, emerg

    An optional logging severity assigned to all the failed requests with response status code 500 or higher. Available options: debug, info, notice, warning, err, crit, alert, emerg.

  • timeout

    number default: 10000

    An optional timeout in milliseconds when sending data to the Loggly server.

  • custom_fields_by_lua

    map

    A list of key-value pairs, where the key is the name of a log field and the value is a chunk of Lua code, whose return value sets or replaces the log field value.