Integrate with Sumo Logic

Integrate StackRox with Sumo Logic logs and metrics management platform.

If you are using Sumo Logic, you can forward alerts from the StackRox Kubernetes Security Platform to Sumo Logic. This guide explains how to integrate the StackRox Kubernetes Security Platform with Sumo Logic.

Integrating with Sumo Logic requires version 2.4.22 or newer. If you are on an older version, see the Upgrade StackRox page for upgrade instructions.

To forward alerts from the StackRox Kubernetes Security Platform to Sumo Logic:

  1. Add a new Custom App in Sumo Logic, set HTTP source, and get the HTTP URL. See Configure Sumo Logic.
  2. Use the HTTP URL to integrate Sumo Logic with the StackRox Kubernetes Security Platform. See Configure the StackRox Kubernetes Security Platform.
  3. Identify policies for which you want to send notifications, and update the notification settings for those policies. See Configure policy notifications.

Alerts in Sumo Logic
Alerts in Sumo Logic

Configure Sumo Logic

Use the Setup Wizard to set up Streaming Data and get the HTTP URL.

  1. Log in to your Sumo Logic Home page and select Setup Wizard.
  2. Move your cursor over to Set Up Streaming Data and select Get Started.
  3. On the Select Data Type page, select Your Custom App.
  4. On the Set Up Collection page, select HTTP Source.
  5. Enter a name for Source Category (we recommend using “stackrox”) and select Continue.
  6. Copy the generated URL.

Configure the StackRox Kubernetes Security Platform

Create a new integration in the StackRox Kubernetes Security Platform by using the HTTP URL.

  1. Navigate to Platform Configuration > Integrations.
  2. Under the Plugins section, select Sumo Logic.
  3. Select the New Integration icon.
  4. Enter a name for Integration Name.
  5. Enter the generated HTTP URL in the HTTP Collector Source Address box.
  6. Select Test (checkmark icon) to test that the integration with Sumo Logic is working.
  7. Select Create (save icon) to create the configuration.

Configure policy notifications

  1. Navigate to Platform Configuration > System policies.
  2. Select the check boxes for one or more policies for which you want to send alerts.
  3. Select Enable Notifications or Actions > Enable Notification (depends upon the StackRox Kubernetes Security Platform version you are using).
  4. In the Enable Notifications dialog, select the check box for the Sumo Logic notifier (same as the Integration Name). If you haven’t configured any other integrations, you’ll see the message No notifiers configured!.
    Configure policy notifications
    Configure policy notifications
  5. Select Enable.

View alerts in Sumo Logic

To view the StackRox Kubernetes Security Platform alerts in Sumo Logic:

  1. Log in to your Sumo Logic Home page and select Log Search.
  2. In the search box, enter _sourceCategory=stackrox. Make sure to use the same Source Category name that you entered while Configuring Sumo Logic.
  3. Select the time and then select Start.
  • The StackRox Kubernetes Security Platform sends notifications on an opt-in basis. To receive notifications, you must first assign a notifier to the policy.

  • Notifications are only sent once for a given alert. If you have assigned a notifier to a policy, you won’t receive a notification unless a violation generates a new alert. The StackRox Kubernetes Security Platform creates a new alert when:

    • a policy violation occurs for the first time in a deployment, or
    • a runtime-phase policy violation occurs in a deployment after you resolved the previous runtime alert for that policy in that deployment.

Questions?

We're happy to help! Reach out to us to discuss questions, issues, or feature requests.

© 2021 StackRox Inc. All rights reserved.