Enable the Davis Rocket.Chat bot

The Davis Rocket.Chat bot is currently in beta.

Requirements

  • Administrative permissions for Davis and Rocket.Chat server
  • Firewall must have port 443 opened to receive HTTP requests from Davis to Rocket.Chat server
  • Environment selected for integration must use the beta Davis conversation engine

Note: If your Rocket.Chat bot username differs from "davis", replace "davis" with your custom bot username throughout the documentation below.

Create a Rocket.Chat bot user

Create Rocket.Chat bot user demo animation

  1. Sign in to your Rocket.Chat server and click the Options ("...") button near the top-left corner of the window.

  2. Click Administration, then click the Users side-menu item.

  3. Click the Add User ("+") button near the top-right corner of the window.

  4. Type and set the following:

    • Name: Dynatrace Davis
    • Username: davis (recommended)
    • Email: Used for account recovery. Use an email address that's not already assigned to a Rocket.Chat user.
    • Verified: Disabled (red)
    • Password
    • Require password change: Disabled (red)
    • Roles: bot
  5. Click Save.

Note: Rocket.Chat doesn't currently offer a way to force bots to appear online. Since the Davis bot relies on webhooks for connectivity, the bot user will always appear to be offline when their username appears in the side-menu. This is normal behavior and should be ignored until Rocket.Chat provides the missing functionality.

Add Rocket.Chat integration for an environment in Davis

Add Davis Rocket.Chat integration demo animation

  1. Open a new tab and go to davis.dynatrace.com.
  2. Sign in and open the User profile menu in the top-right corner of the window.
  3. Click Account settings and navigate to Integrations > Rocket.Chat.
  4. Select the environment to be used with the Rocket.Chat integration.
  5. If the selected environment isn't using the beta conversation engine, click the Use beta conversation engine button and accept the desired privacy options.
  6. Enter your Rocket.Chat server URL.
  7. Enter your Rocket.Chat bot's username and password.
  8. Click the Copy button next to the token, then click the Add button.

Create a webhook for channel messages in Rocket.Chat

Create webhook for channel messages in Rocket.Chat demo animation

  1. Navigate to your Rocket.Chat server and click the Options ("...") button near the top-left corner of the window.
  2. Click Administration, then click the Integrations side-menu item.
  3. Click the New integration button near the top-right of the window.
  4. Click the Outgoing Webhook list item.
  5. Type and set the following:
    • Event Trigger: Message Sent
    • Enabled: True
    • Name: Dynatrace Davis - Channel Messages
    • Channel: all_public_channels, all_private_groups
    • Trigger Words: @davis
    • URLs: https://davis.dynatrace.com/rocketchat/v1/messageSent
    • Post as: davis (or your bot's username)
    • Avatar URL: https://s3.amazonaws.com/dynatrace-davis/assets/images/davis-rocketchat-avatar.svg
    • Token: Copy/paste from Rocket.Chat integration configuration in Davis
  6. Click the Save changes button.

Create a webhook for direct messages in Rocket.Chat

Create a webhook for direct messages in Rocket.Chat demo animation

  1. Click Back to integrations in the top-left corner of the window.
  2. Click the New integration button in the top-right corner of the window.
  3. Click the Outgoing Webhook list item.
  4. Type or set the following:
    • Event Trigger: Message Sent
    • Enabled: True
    • Name: Dynatrace Davis - Direct Messages
    • Channel: @davis
    • URLs: https://davis.dynatrace.com/rocketchat/v1/messageSent
    • Post as: davis (or your bot's username)
    • Avatar URL: https://s3.amazonaws.com/dynatrace-davis/assets/images/davis-rocketchat-avatar.svg
    • Token: Copy/paste from Rocket.Chat integration configuration in Davis
  5. Click the Save changes button.

Interact with Davis in a Rocket.Chat channel

Interact with Davis in a Rocket.Chat channel demo animation

Begin interacting with Davis in a Rocket.Chat channel by prefacing each message with @davis or whatever username you provided for your Rocket.Chat bot user.

Interact with Davis directly in Rocket.Chat

As an alternative to interacting with Davis in a channel, you can interact directly with Davis in a direct message. Add "davis" to your Direct Messages list in Rocket.Chat by clicking the magnifying glass button in the top-left corner of the window and typing davis. Click the matching username to start a new direct message. The conversation won't be visible to any other users and Davis will always be listening.

Note: You aren't required to preface messages with @davis in direct messages.

Interact with multiple Dynatrace environments

Davis supports interaction between multiple Dynatrace environments per Rocket.Chat server. If you'd like to add support for interacting with multiple Dynatrace environments in Rocket.Chat, consider using custom bot usernames that indicate the associated environment (for example, "davis-mysite-prod"). Note: Each added Rocket.Chat integration must have a different bot user to avoid conflicts.

Enable Davis to send notifications through Rocket.Chat

To enable notifications, send enable notifications in a direct message to Davis or @davis enable notifications in a channel. Learn more

Delete a Davis Rocket.Chat integration for an environment

To delete a Davis Rocket.Chat integration, select the environment associated with the integration within the Integrations - Rocket.Chat configuration section and click the Delete integration for environment button.