Sensu Plus

COMMERCIAL FEATURE: Access Sensu Plus in the packaged Sensu Go distribution. For more information, read Get started with commercial features.

Sensu Plus is a built-in integration you can use to transmit your Sensu observability data to Sumo Logic via the Sumo Logic HTTP Logs and Metrics Source. You can use Sumo Logic’s interactive dashboards and analytics tools to get better visibility into your Sensu data.

To use Sensu Plus, you need a Sumo Logic account. Once you have an account, follow this guide to start sending your Sensu data to Sumo Logic.

Set up an HTTP Logs and Metrics Source

Set up a Sumo Logic HTTP Logs and Metrics Source to collect your Sensu observability data:

  1. In the Sumo Logic left-navigation menu, click Manage Data and Collections.

    Open the Collections tab
  2. At the top-right of the Collection tab, click Add Collector.

    Add a Sumo Logic collector
  3. In the Click Selector Type modal window, click Hosted Collector.

    Select the hosted collector option
  4. In the Add Hosted Collector modal window:

    • Type sensu in the Name field.
    • Click Save.
    Name the hosted collector
  5. In the Confirm prompt, click OK.

    Confirm your hosted collector configuration
  6. Under Cloud APIs, click HTTP Logs & Metrics.

    Select the HTTP Logs & Metrics source
  7. In the HTTP Logs & Metrics form:

    • Type sensu-http in the Name field.
    • Type sensu-events in the Source Category field.
    • Click Save.
    Select options for HTTP Logs & Metrics source
  8. In the HTTP Source Address prompt, copy the listed URL and click OK. You will use this URL as the value for the url attribute in your Sensu handler definition.

    Retrieve the HTTP Source Address URL

Create a handler in Sensu

To send your Sensu observability data to your new Sumo Logic HTTP Logs and Metrics Source, create a Sensu handler.

We recommend creating a Sumo Logic metrics handler because they provide a persistent connection to transmit Sensu observability data, which helps prevent the data bottlenecks you may experience with traditional handlers. However, you can use a traditional handler instead if desired, and our Sumo Logic handler integration includes templates to get you started.

For a Sumo Logic metrics handler, the resource definition must use the URL you copied in the last step of setting up your HTTP Logs and Metrics Source as the value for the url attribute.

Here is an example Sumo Logic Metrics Handler definition:

---
type: SumoLogicMetricsHandler
api_version: pipeline/v1
metadata:
  name: sumologic_http_log_metrics
  namespace: default
spec:
  url: "https://https://collectors.sumologic.com/receiver/v1/http/xxxxxxxx"
  max_connections: 10
  timeout: 10s
{
  "type": "SumoLogicMetricsHandler",
  "api_version": "pipeline/v1",
  "metadata": {
    "name": "sumologic_http_log_metrics",
    "namespace": "default"
  },
  "spec": {
    "url": "https://https://collectors.sumologic.com/receiver/v1/http/xxxxxxxx",
    "max_connections": 10,
    "timeout": "10s"
  }
}

If you prefer, you can configure your Sumo Logic HTTP Logs and Metrics Source URL as a secret with Sensu’s built-in env secrets provider to avoid exposing the URL in your handler definition. This example shows the same definition with the URL referenced as a secret instead:

---
type: SumoLogicMetricsHandler
api_version: pipeline/v1
metadata:
  name: sumologic_http_log_metrics
  namespace: default
spec:
  url: $SUMO_LOGIC_SOURCE_URL
  secrets:
  - name: SUMO_LOGIC_SOURCE_URL
    secret: sumologic_metrics_us1
  max_connections: 10
  timeout: 10s
{
  "type": "SumoLogicMetricsHandler",
  "api_version": "pipeline/v1",
  "metadata": {
    "name": "sumologic_http_log_metrics",
    "namespace": "default"
  },
  "spec": {
    "url": "$SUMO_LOGIC_SOURCE_URL",
    "secrets": [
      {
        "name": "SUMO_LOGIC_SOURCE_URL",
        "secret": "sumologic_metrics_us1"
      }
    ],
    "max_connections": 10,
    "timeout": "10s"
  }
}

Make sure to add your Sumo Logic metrics handler to a pipeline, and reference the pipeline in the check you’re using to collect your metrics data.

NOTE: Sumo Logic metrics handlers only accept metrics events. To send status events, use the Sensu Sumo Logic Handler integration.

Configure Sumo Logic dashboards

You can configure Sumo Logic dashboards to view your Sensu observability data in any way you wish. As a starting point, follow these instructions to configure Sensu Overview and Sensu Entity Detail dashboards:

  1. On your Sumo Logic home page, click the Personal tab in the left-navigation menu. Click the options icon for the folder where you want to import your Sensu data and select Import.

    Navigate to the folder where you want to import Sensu data
  2. In the Import Content modal window:

    Import Content modal window for dashboards
  3. Scroll to the end of the Import Content modal window and click Import.

The two new dashboards will be listed in the Sensu sub-folder in the left-navigation menu:

Sensu Overview and Sensu Entity Detail dashboards listed in the Sumo Logic left-navigation menu

Click a dashboard name to view your Sensu observability data.