Getting started with Davis CoPilot

Davis CoPilot is enabled on the account level by default, meaning that all your environments automatically have access to it. However, Davis CoPilot functionality must still be enabled on the environment level via the settings page, which offers you full control over how Davis CoPilot is enabled and configured in your environment.

Enable Davis CoPilot on your environment

  1. Go to Settings > Dynatrace Service Settings > Davis CoPilot.
  2. Turn on Enable Davis CoPilot.

If you can't see the settings page, make sure you have Setting Reader and Setting Writer policies assigned. For more information, see read and write permission.

Davis CoPilot is available only for SaaS environments running the latest Dynatrace.

  • For Dynatrace Platform Subscription holders, Davis CoPilot is available with the release of Dynatrace version 1.301.
  • For classic license holders, Davis CoPilot is planned to become available with the release of Dynatrace version 1.304.

User permissions

After enabling Davis CoPilot on the environment level, you'll still need to give access to Davis CoPilot to your users. To do so, you have to bind the group they belong to a policy with the following statement that allows access to Davis CoPilot:

  • Natural language to DQL translation (ALLOW davis-copilot:nl2dql:execute;)

For more information on managing your policies, see Manage IAM policies.

User-based data access

Since Davis CoPilot respects user privileges, it may provide different responses to different users based on their access rights.

Enable environment-aware queries

Environment-aware queries can enrich Davis CoPilot with your environment's data. This lets you generate more accurate queries that identify and reference relevant entities, events, spans, logs, and metrics from your environment.

If you want Davis CoPilot to be aware of the details and structures of your environment's data, you'll need to allow access to Grail. To ensure you have full control over the security of your data, this functionality is opt-in, and admin users can specify which data tables and buckets Davis CoPilot is not allowed to access.

To enable environment-aware queries

  1. Go to Settings > Dynatrace Service Settings > Davis CoPilot.
  2. Turn on Enable environment-aware queries.

It can take up to 24 hours for Davis CoPilot to build or amend the semantic index after changes are made. If environment-aware queries are disabled and the semantic index already exists, Davis CoPilot purges all environment-specific data within 24 hours, and returns to using publicly available sources for building DQL queries. The semantic index is stored only on your Dynatrace tenant.

To learn more about semantic indexing and environment-aware queries, see Environment-aware queries.

Configure your data access

After enabling environment-aware queries, you'll be able to see the settings for configuring data that Davis CoPilot isn't allowed to access.

To configure your data access

  1. Go to Configure data access.
  2. Select Add a new rule.
  3. Select the type of data you want to exclude from Davis CoPilot access in the Type field.
  4. Type the name of the bucket or table in the Name field.
  5. Select Save changes.