Skip to content

Commit

Permalink
Removes 'create with AI' content; copy-editing (#22801)
Browse files Browse the repository at this point in the history
Removes another instance of the 'create with AI' content. Adds a bunch of copy editing.
  • Loading branch information
neko-dd authored Apr 23, 2024
1 parent 13888a3 commit f8ffcbc
Show file tree
Hide file tree
Showing 4 changed files with 50 additions and 67 deletions.
8 changes: 4 additions & 4 deletions content/en/service_management/app_builder/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,15 +19,15 @@ further_reading:
Datadog App Builder is in private beta. Complete the form to request access.
{{< /callout >}}

Datadog App Builder is a low-code application building platform that streamlines the development of your internal tools with a user-friendly drag-and-drop interface and built-in support for JavaScript. App Builder makes use of integrations with popular services such as AWS and GitHub, allowing you to leverage data and seamlessly connect with external APIs and data stores. By integrating with Datadog's existing capabilities, App Builder provides a centralized context, empowering you to take preventive actions or respond to ongoing incidents, all within the same view you use for troubleshooting.
Datadog App Builder is a low-code application building platform. It streamlines the development of your internal tools with a user-friendly drag-and-drop interface and built-in support for JavaScript. App Builder integrates with popular services such as AWS and GitHub, allowing you to leverage data and seamlessly connect with external APIs and data stores. By integrating with Datadog's existing capabilities, App Builder provides a centralized context that enables you to take preventive actions or respond to ongoing incidents, all from within the same view that you use for troubleshooting.

{{< img src="/service_management/app_builder/datadog-app-builder-1.png" alt="An app in App Builder" style="width:100%;" >}}

## Configure App Builder actions

Datadog App Builder provides an [Action Catalog][1] of over 300 actions across several integrations. The Action Catalog and the connection credentials for each integration are shared with [Datadog Workflow Automation][2]. If there isn't an integration that accomplishes your task, generic actions such as the HTTP request and JavaScript function allow you to perform any task your app requires.
Datadog App Builder provides an [Action Catalog][1] of over 300 actions across multiple integrations. The Action Catalog and the connection credentials for each integration are shared with [Datadog Workflow Automation][2]. If there isn't an integration that accomplishes your task, you can use generic actions such as the HTTP request and JavaScript function to perform any task that your app requires.

{{< img src="/service_management/app_builder/app-builder-actions.png" alt="Datadog App Builder provides an Action Catalog of over 300 actions across several integrations." style="width:100%;" >}}
{{< img src="/service_management/app_builder/app-builder-actions.png" alt="Datadog App Builder provides an Action Catalog of over 300 actions across multiple integrations." style="width:100%;" >}}

## Start with blueprints

Expand All @@ -45,7 +45,7 @@ Below are a few examples of what App Builder apps can do:

## Take action directly from dashboards

Use your apps from the Apps page, or access them independently from dashboards. Datadog Apps function as native dashboard integrations, allowing you to customize and take action on your data straight from your Dashboard.
You can use your apps from the Apps page or access them directly from within your dashboards. Datadog Apps function as native dashboard integrations, allowing you to customize and take action on your data straight from your Dashboard.

{{< img src="/service_management/app_builder/app-builder-embedded-dashboard-1.png" alt="An app embedded in a dashboard" style="width:100%;" >}}

Expand Down
36 changes: 18 additions & 18 deletions content/en/service_management/app_builder/auth.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ A few tools control access and authentication for apps and their components.

Because app [actions][1] connect with external software systems, you may need to authenticate your Datadog account to a corresponding integration. An app can run successfully only if every action that requires authentication can verify the identity of your Datadog account.

Actions can be authenticated in two ways:
Actions can be authenticated in the following ways:
- Credentials and permissions configured in the integration tile
- Connection credentials

Expand All @@ -30,56 +30,56 @@ For more information on configuring credentials, see [Connections][2]. App Build

Use [role-based access control (RBAC)][4] to control access to your apps and connections.

The coarse permissions that apply to apps include Apps View, Apps Write, and Connections Read.
The coarse permissions that apply to apps include the following:

Apps View
: Can view and run apps. Datadog Standard and Admin roles have view access to App Builder by default.
: View and run apps. Datadog Standard and Admin roles have view access to App Builder by default.

Apps Write
: Can create and edit new and existing apps. Datadog Standard and Admin roles have write access to App Builder by default.
: Create and edit new and existing apps. Datadog Standard and Admin roles have write access to App Builder by default.

Connections Read
: Can list and view available connections. Datadog Read Only, Standard, and Admin roles have read access to connections by default.
: List and view available connections. Datadog Read Only, Standard, and Admin roles have read access to connections by default.

### Restrict access to a specific connection

Set permissions on each connection to limit modifications or restrict their use. The granular permissions include **Viewer**, **Resolver**, and **Editor**.
Set permissions on individual connections to restrict their use or limit modifications. App Builder provides the following permissions for each connection:

Viewer
: Can view the connection
: View the connection

Resolver
: Can resolve and view the connection
: Resolve and view the connection

Editor
: Can edit, resolve, and view the connection
: Edit, resolve, and view the connection

Resolving a connection includes getting the connection object assigned to a step and retrieving the secret associated with it.
**Note**: Permission to resolve a connection includes permission to get the connection object assigned to a step and retrieve the secret associated with it.

Use the following steps to modify the permissions on a specific connection:

1. Navigate to the [App Builder page][5].
1. Click the **Connections** tab. A list of connections appears.
1. Hover over the connection on which you would like to set granular permissions. **Edit**, **Permissions**, and **Delete** icons appear on the right.
1. Hover over the connection that you would like to set granular permissions on. **Edit**, **Permissions**, and **Delete** icons appear on the right.
1. Click the padlock (**Permissions**) icon.
1. Select **Restrict Access**.
1. Select a role from the dropdown menu. Click **Add**. The role you selected populates into the bottom of the dialog box.
1. Next to the role name, select your desired permission from the dropdown menu.
1. Select a role from the dropdown menu and click **Add**. The role you selected populates into the bottom of the dialog box.
1. Next to the role name, select the desired permission from the dropdown menu.
1. If you would like to remove access from a role, click the trash can icon to the right of the role name.
1. Click **Save**.

### Restrict access to a specific app

Set permissions on each app to restrict modifications to the app. The granular permissions include **Viewer** and **Editor**.
Set permissions on each app to restrict modifications to the app. App Builder provides the following permissions for each app:

Viewer
: Can run and view the app
: Run and view the app

Editor
: Can edit, run, and view the app
: Edit, run, and view the app

Restrict access while editing the app in the app canvas.
1. First, navigate to the detailed editing view for the app for which you want to restrict access.
To restrict access to the app, perform the following steps in the app canvas:
1. Navigate to the detailed editing view for the app you want to restrict access to.
1. In the app editor, click on the cog (**Settings**) icon.
1. Select **Permissions** from the dropdown.
1. Select **Restrict Access**.
Expand Down
Loading

0 comments on commit f8ffcbc

Please sign in to comment.