README.md

Overview

Azure DevOps extention allows you to integrate Deployment Event into your release pipelines.

The extension supports the following event types, so a number of use cases can be supported.

1. deployment event - used when code is deployed
2. configuration event - used when configuration change is perfomed
3. custom event - general purpose event. could be used for events like performance test start or stop

**DISCLAIMER: The marketplace extension is intended for demonstration purposes. This is not developed or supported by Dynatrace. That said, feel free to install the extension and try it out. To incorporate these extensions into your environment, checkout this. GitHub repo.

Install the extension

1. Goto Azure extension marketplace

2. Search for "Dynatrace Push Event"

3. Click on the "Get it free" button to install to your Azure DevOps organization

4. Once installed it should look like this

   

Add push event task to your pipeline

Within a release pipeline, use the drop down to choose the Event Type and give the task a name such as Push Dynatrace Deployment Event.

You need to define variables for the Dynatrace tenant and API Token.

1. dynatraceTenantUrl = (YOUR TENANT) e.g. https://(YOUR TENTANT).live.dynatrace.com
2. dynatraceApiToken = (YOUR TOKEN)

Use a variable group as shown here for re-use across pipelines and be sure to set the valies and as hidden.

Dynatrace configuration

Once you have a variable group, link it to the pipeline.

Arguments

Many of the arguments defaults to builtin DevOps pipeline variables, but you can adjust these for your needs.

The Tag Match Rule must conform to value the formated expected for the TagMatchRule within the Dynatrace Deployment Event API. Below is an example:

[{
    "meTypes": "SERVICE",
    "tags": [{
        "context": "ENVIRONMENT",
        "key": "environment",
        "value": "demo"
    }, {
        "context": "ENVIRONMENT",
        "key": "service",
        "value": "demo-node-app"
    }]
}]

The Custom Properties is an optional field to add in custom information. Use this to set your information for the application, deployment or configuration change.

Below is an example for a deployment event:

{
    "Deployment Start Time": "$(DeploymentEventStartTime)",
    "Deployment End Time": "$(DeploymentEventEndTime)",
    "Application": "$(Application)",
    "Application Owner": "$(ApplicationOwner)",
    "Release Reason": "$(Release.Reason)",
    "Release Requested For": "$(Release.RequestedFor)",
    "Release Description": "$(Release.ReleaseDescription)"
}

Viewing an Event

The events are viewed within Dynatrace on the services, process or hosts page.

The example below is a Deployment event with the Custom Properties set from the example above.