Datadog Mobile App

Datadog Mobile App

The Datadog Mobile app enables you to view alerts from Datadog on your mobile device. When receiving an alert via Slack, e-mail, Pagerduty or other pager apps, you’ll be able to investigate issues by opening monitor graphs and dashboards on your mobile device.

Installing

Download the app from the Apple App Store for your iOS device, or from the Google Play store for your Android device.

Logging in

You can log in using standard authentication, Google authentication, or SAML - for both the US and the EU region.

Enabling SAML

SAML login requires you to set up and authenticate your SAML provider with Datadog. For SAML IdP-initiated login, refer to the end of this section. To authenticate SAML:

  1. Press the “Using Single Sign-On (SAML)?” button.
  2. Enter your company email and send the email.
  3. While on your mobile device, open the email and click on the indicated link.
  4. Enter your org’s SAML credentials, which upon success will reroute to an authenticated session of the Datadog mobile app.

Optionally, you may also authenticate through a QR Code or manual entry, outlined below.

QR code
  1. Start by logging in to your Datadog account profile page in a browser and click the Link mobile device button of the organization you want to log into. This pops up a QR code.
  2. Use your default phone camera app to scan the QR code and then tap the suggested link to open the Datadog App. The org UDID is automatically inserted into the login screen.
Manual entry
  1. To manually enter the SAML ID, open the Datadog Mobile app and press the “Using Single Sign-On (SAML)?” button.
  2. Press the “Use another method to login” button, and enter the SAML ID manually.

By clicking Authorize when logging in, you link the mobile device you’re using to your account. For security purposes, you will have to go through this flow once per month.

SAML IdP initiated login

If you keep getting errors while trying to login with SAML, your identity provider may enforce IdP-initiated login. For more information regarding enabling IdP initiated SAML, please see our IdP initiated SAML page IdP Initiated SAML page

Monitors

On the Monitors page, you can view and search all of the monitors that you have access to in your Datadog org. You can specify by field name and build-specific search queries based on your tagging strategy. For more information about search, see the Manage Monitors Search section.

For example, to filter on metric monitors related to the SRE team that is being alerted, use the query "status:Alert type:Metric team:sre". Click into individual alerts to see details, which can be filtered by type and by alert time. You can also mute the alert. Your ten most recent searches are saved so that you have faster access previous queries. Furthermore, you can filter your monitor list using saved views, which surface when you activate the search bar. Lastly, view and run synthetic tests when viewing your synthetic monitors.

Note: To set up or edit monitors, notifications, or saved views, you need to do it in the Datadog web app. All monitors set up in the web app are visible in the mobile app. For more information, see Creating monitors.

Dashboards

On the Dashboards page, you can view and search all of the dashboards that you have access to in your Datadog org, and filter them using the same template variables you have set up in the Datadog web app. Quickly filter your dashboards using template variable saved views. For more information about template variable saved views, see Dashboard Saved Views. Click on an individual dashboard to view it.

Note: To set up or edit a dashboard, you need to login to the Datadog browser app. For more information, see Dashboards.

Incidents

On the Incidents page, you can view, search and filter all incidents that you have access to in your Datadog account from the Datadog Mobile App to ensure quick response and resolution from anywhere. You can also declare and edit incidents and seamlessly communicate to your teams through integrations with Slack, Zoom, and many more. For more information about Incidents, see the Datadog Incident Management documentation.

Create an incident

  1. Navigate to the incident list by clicking on the Incidents Tab in the bottom bar.
  2. Click the “+” button in the top right corner.
  3. Give your incident a title, severity, and commander.

Widgets

Monitor saved views

View your monitor saved views from your home screen with Datadog widgets. Tap on any saved view cell to open the “Monitor Search” screen in the app, with your saved view already filled in.

Note: If you do not have any monitor saved views, the widget shows you all monitors by default.

Create a widget

  • Long press on the home screen.
  • Tap the “+” button on the top left corner of the screen.
  • Search for “Datadog” widgets.
  • Select your prefered size (small shows two monitor saved views, medium allows up to three monitor saved views, and large up to six monitor saved views).
  • Place the widget in your desired, onscreen location.
  • Open the Android Widget Picker.
  • Either long press your home screen, or long press the Datadog app icon.
  • Tap on “Widgets”. If you have app shortcuts, it might appear as just an icon on the top right corner of the bubble.
  • Drag the Monitor Saved Views widget on your home screen.

Edit a widget

  • Long press on the widget to configure.
  • Tap on “Edit Widget”.
  • Tap on the individual saved view cell to select and deselect.
  • Reorder the views by dragging and dropping each cell.
  • Tap out of the widget to validate your selection and exit the configuration screen.
  • Tap on the widget title to configure.
  • Tap on “Saved views”.
  • Tap on the individual saved view cell to select and deselect.
  • Reorder the views by dragging and dropping each cell.
  • Tap “Save” to validate your selection and exit the configuration screen.
  • Scroll the widget to see more saved views. Long press and resize the widget to fit your preference.

Multiple organizations

You can display Saved Views from multiple organizations within the same widget.

All organizations you’ve logged-in are displayed in the configuration screen. If you do not see your organization, you may need to sign in again.

  • From the configuration screen, tap on “Organization”.
  • Select a new organization (you might need to sign in).
  • Tap “Saved Views”. Select saved views to display or leave it as is.
  • Tap “Save”. The widget is now configured with saved views from a different organization.

Delete a widget

Delete a widget pressing the “-” button at the top left of the widget when editing your home screen, or by long pressing on the widget and then selecting “Remove Widget”.

Delete a widget by long pressing, dragging, and dropping the widget on the “Remove” button.

Quick actions

Long-press on the app icon to surface a quick-action sheet of your top five Frequently Viewed By Me dashboards for iOS (measured by view count and recency) and your five most opened dashboards on mobile for Android. Press on a result to open the dashboard in-app.

Search from home screen

iOS only: Within iPhone Search, filter and search for the name of any desired dashboard. Press on a result to open the dashboard view directly on the mobile app, or press the “Search in App” button to open the search query in the in-app Dashboard List page.

Shortcuts and Siri suggestions

Android: Create shortcut icons for your dashboards by touching and holding the Datadog app icon, then lift your finger. If the app has shorcuts, it displays a list. Touch and hold the desired shortcut, then drag and drop it to another location on your screen to create a unique shortcut icon.

iOS: Create Siri Shortcuts for Datadog dashboards and monitors through the Shortcuts App. For a shortcut to be available for creation, you must execute the desired action at least once in the app. For example, to create an “Open AWS Overview Dashboard” shortcut, open the AWS Overview Dashboard in your mobile app at least once.

With the shortcut, you can access your dashboards and monitors through three key actions:

  • Pin the shortcut as an icon in your home screen. To do so, access the Shortcuts app, and open the edit menu for your dashboard shortcut.
  • Siri Voice: say your shortcut name, such as “Open AWS Overview”, and Siri opens your dashboard in-app.
  • Siri suggestions: Siri learns your routine, and suggests dashboard shortcuts when you most need them, through a home or lock-screen banner, iPhone search, or iOS 14 Siri Suggestions widgets.

For more information on Siri Shortcuts and Suggestions, refer to the Apple Siri Documentation.

Handoff

iOS Only: Use Apple Handoff to continue your task across Apple devices. While in use, the icon of the Datadog mobile app appears on your Mac at the left end of the Dock. Click on the icon to open your current dashboard or monitor on your Mac.

For Handoff to work, each device must:

  • Be signed in to iCloud with the same Apple ID
  • Have Bluetooth enabled
  • Have Wi-Fi enabled
  • Have Handoff enabled

For more information on Handoff, refer to the Apple Handoff Documentation.

Account

Switch organizations or log out from the Account page.

Troubleshooting

For help with troubleshooting, contact Datadog support. You can also send a message in the Datadog public Slack #mobile-app channel.

Further Reading

Additional helpful documentation, links, and articles: