Stackstate-Kong Integration

Overview

Connect Kong to Stackstate to:

  • Visualize Kong performance data
  • Correlate the performance of Kong with the rest of your applications

Setup

Configuration

Configure the Agent to connect to Kong. Edit conf.d/kong.yaml

init_config:

instances:
# For every instance, you have an `kong_status_url` and (optionally)
# a list of tags.

-   kong_status_url: http://example.com:8001/status/
    tags:
        -   instance:foo

-   kong_status_url: http://example2.com:8001/status/
    tags:
        -   instance:bar

Validation

To validate that the integration is working, restart the agent and then run the info command (For help on these steps, see Getting Started with the Agent. You should see output that validates that the check passed.

Data Collected

Metrics

kong.table.count
(gauge)
Total number of tables in the database.
shown as table
kong.table.items
(gauge)
Number of items in each table of the database.
shown as row
kong.connections_accepted
(gauge)
Total number of accepted client connections.
shown as connection
kong.connections_active
(gauge)
Current number of active client connections including Waiting connections.
shown as connection
kong.connections_handled
(gauge)
Total number of handled connections. (Same as accepts unless resource limits were reached).
shown as connection
kong.connections_reading
(gauge)
Current number of connections where Kong is reading the request header.
shown as connection
kong.connections_waiting
(gauge)
Current number of idle client connections waiting for a request.
shown as connection
kong.connections_writing
(gauge)
Current number of connections where nginx is writing the response back to the client.
shown as connection
kong.total_requests
(gauge)
Total number of client requests.
shown as request