Instana
Use the Instana integration to ingest issues or incidents raised by build-in or custom events, and respond to them automatically.

Overview

Instana is an Application Performance Management (APM) solution designed for the challenges of managing microservices and cloud-native applications.
It gives you the ability to create alerts from build-in events which are predefined health signatures based on integrated algorithms, or from custom events which allows you to create issues or incidents based on an individual metric of any given entity.

Use Cases

The integration between Fylamynt and Instana lets you:
  • Trigger a workflow in Fylamynt, when a specific Instana Alert goes into the state of ALERT.

Configure Instana in Fylamynt

  • Navigate to Settings -> Integrations -> Instana.
Details needed to set up Instana instance in Fylamynt:
Parameter
Description
Instana API Key
API Token obtained from Instana
Instana URL
Instana URL, example: https://foobar.instana.io)
Webhook API Key Name
Fylamynt API Key Name for webhook authentication
Webhook API Key Value
Fylamynt API Key Value for webhook authentication
Instana Webhook URL
Fylamynt Webhook URL to be used by Instana service

Instructions to setup Instana Integration

Follow the steps listed below in your Instana Account and get the desired parameters to enter in Fylamynt.
  • Login to your Instana Account.
  • Copy the URL of your Instana site and paste it into the Instana URL field under Authorize Fylamynt.
  • Go to Settings -> Team Settings -> ACCESS CONTROL -> API Tokens.
  • Click Add API Token to create a new token (or) select an existing API Token.
  • For least privileged access, enable “Configuration of custom alerts” permissions.
  • Click Save
  • View and Copy the token and paste it into the Instana API Key field under Authorize Fylamynt.
  • Go to Settings -> Team Settings -> EVENTS & ALERTS -> Alert Channels
  • Click on Add Alert Channel and select Generic Webhook
  • Add the below details to Create Generic Webhook Alert Channel
    • Enter the name for the Webhook alerts channel e.g. "Fylamynt-webhook"
    • Copy the Instana Webhook URL from Authorize Fylamynt card on the integration settings page and paste it into the Webhook URL
    • Under Custom HTTP Request Headers, select “Add Header”
      • Add "x-api-key" as Key
      • In the Authorize Fylamynt card on the integration settings page, select one of the Webhook API Key Name from the dropdown, and the corresponding Webhook API Key Value will be made visible.
      • If no options are available for the Webhook API Key Name, first go to Settings --> API Keys --> Manage Keys to Create a New API Key.
      • Copy the Webhook API Key Value from Authorize Fylamynt card on the integration settings page, and paste it into the Value field of the x-api-key key
    • From Authorize Fylamynt card on the integration settings page, check to see if all the attributes are filled correctly.
    • Click on Authorize to finish Instana integration with Fylamynt.
    • Before saving the Alert Channel details click on Test Channel to verify that the Alerting Channel was successfully triggered.
    • Click “Create”
  • Go to Settings -> Team Settings -> EVENTS & ALERTS -> Alerts
  • Click on New Alert
  • Add the below details to Create New Alert
    1. 1.
      Enter the name for the Alert Configuration
    2. 2.
      Under Events, select to send alerts on Event(s) or send alerts by Event Type(s)
    3. 3.
      If Alert on Events is selected, click on Add Events and select all relevant events
    4. 4.
      Under Alerting, click on Add Alert Channels and select the Alert Channel created in the previous step.
    5. 5.
      Click Create

Integration Actions

You can add the following actions in the Fylamynt workflow builder, as part of your workflow.

Instana Alert Trigger

Integration node triggers a workflow from an Instana alert with Fylamynt specific alert channel.
When creating a workflow, you are presented with a wizard to select the trigger type to use.
  • On the workflow page, select New Workflow
  • Enter the name of the Workflow.
  • Select the Instana trigger type.
  • Click Create Workflow
  • For existing workflows with manual or other trigger types, changing the trigger type is easy.
    • Hover over the trigger and click on the Pencil to edit the trigger type
    • Select the Instana trigger type
    • The trigger is updated on the editor canvas

Automated task management

A Task represents the business layer on top of workflow executions and is used to automatically execute the workflow that is associated with a task type assignment.
Task management contains 3 core pieces which include Task Types, Task Type assignment, and the Task itself.
To automatically execute the workflow with the Instana trigger, the task type and assignment need to be configured. Here are the steps:

Create a Task Type:

  • Fylamynt -> Settings -> Task Types
  • Select New Type
    • Enter the Name of the task
    • Provide a description.
    • Select the workflow created in the previous step
  • Click Create Task Type

Task Type Assignment:

  • Fylamynt -> Settings -> Integration -> Instana -> Task Type assignments
  • Select New Assignment
    • Select the Instana Entity Type
    • Select the Instana Entity Name based on the selected type
    • Select the Corresponding task type created in the previous step.
    • Click Add Assignment
The Instana Entity Type and Name associated with the task type should now be visible under Task Type Assignments.

Automatically execute the workflow:

Verify that an event is created in Instana that is associated with the alert.
In Fylamynt a task is created, which executes the workflow.
Click on Executions tab to view the workflow execution.
Review the steps that are being executed in the workflow with status, input and output information.
Last modified 17d ago