Skip to main content

VMWare Tanzu integration

You can use an APEX AIOps Incident Management custom integration to ingest events from VMWare Tanzu.

Before you begin

Before you set up your VMWare Tanzu integration:

  • Make sure you are signed into your Incident Management instance.

  • Make sure you are signed into VMWare Tanzu.

  • Make sure you have a valid Incident Management API key.

Create a custom integration in Incident Management

  1. Within Incident Management, navigate to Integrations > Ingestion Services > Create your own Integration.

  2. Click Add New Integration.

  3. Under APEX AIOps Incident Management Endpoint, enter a unique name for your new integration (required).

    Note

    The name of the integration can be anything you choose. Incident Management will automatically generate an API endpoint URL independent of what you enter for this field.

  4. Under API Description, enter a description for the integration (optional).

  5. Under Data Type, select Events.

  6. Click Save.

  7. Keep the web page for this integration open in your browser while you complete the following steps in Tanzu.

Create a webhook in Tanzu

  1. Open Tanzu. Navigate to Alerting > Alert Targets.

  2. Click Create Alert Target.

  3. Enter a name and description (required).

  4. For Triggers, select only the following options:

    • Alert Firing

    • Alert Status Updated

    • Alert Resolved

    • Alert Has No Data

    • Alert Has No Data Resolved

  5. Set Type to Webhook.

  6. In the Default Recipient field, paste the endpoint URL for your Incident Management integration.

    The endpoint URL is provided for you in Incident Management on the page for your custom integration, under Configuration Information > APEX AIOps Incident Management Endpoint.

  7. Set Content Type to application/json.

  8. For Custom Headers, create a new custom header with the following fields:

    • Name = apiKey

    • Value = Enter your Incident Management API Key in this field.

    Click the plus button (+) to create the custom header.

  9. For Body Template, click Template and select Generic Webhook.

  10. Click Save at the bottom of the page.

Configure the custom integration in Incident Management

  1. Go to your Incident Management instance.

  2. Open the page for your custom integration by going to Integrations > Ingestion Services > Create your own Integration > your-integration-name.

  3. In the Map Your Data section, you can view cached payloads of incoming events sent from Tanzu. Confirm that events are flowing in before moving on to the next step. This may take some time.

  4. Map your payload fields to the corresponding Incident Management fields. An example mapping is provided for you below as a reference, but you should tailor the mapping according to your business needs.

    For a complete list of mapping types, save options, and instructions on how to use them, read Use mapping types in custom integrations.

    Table 1. Example mapping

    VMWare Tanzu fields

    Incident Management field

    failingSources

    source

    reason, hostsFailingMessage

    description

    name

    check

    severity

    severity

    Click Map Values and map the severity values according to the Severity Mapping Table below.

    failingSeries

    service



    Table 2. Severity mapping

    Tanzu severity field

    Incident Management severity field

    SMOKE

    Minor

    severe

    Critical

    SEVERE

    Critical



  5. Go to the top of the page and click Save.