Creating Dynatrace connections

Creating Dynatrace connections

To create a Dynatrace connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. On the Data and tool connections page, click Add connection.

4. From the list of available connections, find and click the Dynatrace tile.

   Note: If you do not immediately see the connection that you want to create, you can filter the tiles by type of connection. Click the type of connection that you want in the Category section.

5. On the side-panel, review the instructions and when ready to continue, click Connect.

6. On the Add connection page, define the general connection details:

   • Name: The display name of your connection.
   • Description: An optional description for the connection.
   • Endpoint: Dynatrace data source base url. For example, https://<your-environment-id>.live.dynatrace.com.
   • Access Token: Enter an API key for the connection.
   • Orchestration: Select between 'Local' and 'Remote' radio buttons. If you pick 'Remote' and after adding the connection, you'll be provided with a bootstrap command to finish the orchestration.

7. Click Next.

8. Enter the following Collect metric data (Optional): Define how you want to collect metric data.

   • Enabled data collection: Set the 'Enabled data collection' toggle button to 'on'.

     Note: A monitored Metrics note appears telling you that you can select built-in metrics to monitor. These metrics are categorized by the technologies that they are associated with. You can also add custom-defined metrics to monitor.

     You are asked to select a technology to see the list of associated built-in metrics. These technologies include 'Billing', 'Cloud', 'Containers', 'Dashboard' and so on. Depending on which you select the built-in metrics selection varies.

   • Metric filter: If you click the 'Built in Metric Name' checkbox all metrics are checked for the particular Technology you selected in the dropdown menu, and you see the number of possible metrics listed.

   • Additional Metrics: Enter any additional metrics in the free text box. These are custom-defined metrics such as strings separated by commas. For example, metric1, metric2.

   • Metrics API path: Enter the API path to get all applications, for example '/api/v2/metrics/query'

   • Historical or Live: Click either radio button to decide how to collect the data. Historical data start and end date and time must be entered in the following format:

     • Enter Start/End time: Enter the start and end time in the format "hh:mm" (hours and minutes).
     • Localtime: Pick the time zone from the dropdown list.
     • Enter Start/End date: Enter the start and end date in the format "MM/DD/YYYY".

     Note: For historical metric data collection, the recommended time period is two weeks, though you can collect up to 31 days of historical data so your start date should not exceed 31 days from the present.

   If you clicked in the 'Live' Data radio button the fields that you are required to complete are:

   • Connection interval in minutes for live metrics (1-60): The default value here in 1 min.
   • Concurrency limit (1-3): This is the number of concurrent calls allowed.

9. Click Done.

For more information about performance considerations for metric data collection, see Performance considerations for metric data collection.

You created a Dynatrace connection in your instance. After you create your connection, you must enable the data collection to connect your connection with the AI of IBM Cloud Pak for Watson AIOps. For more information about enabling your connection, see Enabling Dynatrace connections.

To create more connections (such as a ChatOps connection), see Configuring data and tool connections.

For more information about working with the insights provided by your connections, see ChatOps insight management.

Enabling and disabling Dynatrace connections

If you didn't enable your data collection during creation, you can enable your connection afterward. You can also disable a previously enabled connection the same way. To enable or disable a created connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. On the Manage connections tab of the Data and tool connections page, click the Dynatrace connection type.

4. Click the connection that you want to enable or disable.

5. Go to the Collect metric data section. Set Enable data collection to On or Off to enable or disable data collection. Disabling data collection for a connection does not delete the connection.

You enabled or disabled your connection. For more information about deleting a connection, see Deleting Dynatrace connections.

Editing Dynatrace connections

After you create your connection, your can edit the connection. For example, if you specified Historical data for initial AI training but now want your connection to pull in live data for continuous monitoring, you can edit it. To edit a connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. Click the Dynatrace connection type on the Manage connections tab of the Data and tool connections page.

4. On the Dynatrace connections page, click the name of the connection that you want to edit. Alternatively, you can click the options menu (three vertical dots) for the connection and click Edit. The connection configuration opens.

5. Edit your connection as required. Click Save when you are done editing.

Your connection is now edited. If your application was not previously enabled or disabled, you can enable or disable the connection directly from the interface. For more information about enabling and disabling your connection, see Enabling and disabling Dynatrace connections. For more information about deleting a connection, see Deleting Dynatrace connections.

Deleting Dynatrace connections

If you no longer need your Dynatrace connection and want to not only disable it, but delete it entirely, you can delete the connection from the console.

To delete a connection, complete the following steps:

1. Log in to IBM Cloud Pak Automation console.

2. Expand the navigation menu (four horizontal bars), then click Define > Data and tool connections.

3. Click the Dynatrace connection type on the Manage connections tab of the Data and tool connections page.

4. On the Dynatrace connections page, click the options menu (three vertical dots) for the connection that you want to delete and click Delete.

5. Enter the name of the connection to confirm that you want to delete your connection. Then, click Delete.

Your connection is deleted.