Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 14 additions & 14 deletions content/en/account_management/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ The personal settings pages in Datadog allow you to control how you appear to ot

### Profile

Your profile is how others in your organization recognize you in Datadog. Set or update your name, email address, and title from the [Profile tab][11] within the **Personal Settings** page.
Your profile is how others in your organization recognize you in Datadog. Set or update your name, email address, and title from the [Profile tab][11] within the {{< ui >}}Personal Settings{{< /ui >}} page.

To update your picture, create an account on [Gravatar][1] and associate it with your email address.

Expand All @@ -34,7 +34,7 @@ If you log in to Datadog using Google authentication, your email address is prov
### Preferences

{{% site-region region="us,us3,us5,eu,ap1,ap2" %}}
You can manage your time zone, time format, visual accessibility preference, and email subscriptions from the [Preferences tab][3] within the **Personal Settings** page.
You can manage your time zone, time format, visual accessibility preference, and email subscriptions from the [Preferences tab][3] within the {{< ui >}}Personal Settings{{< /ui >}} page.

#### Email subscriptions

Expand All @@ -46,12 +46,12 @@ Under email subscriptions, you have access to the following reports:
* Daily Digest
* Weekly Digest

If you are unsure if an email digest is relevant to you, you can view an example by clicking the **Example** link next to each email subscription. You can also use the **Unsubscribe From All** button to unsubscribe from all email subscriptions.
If you are unsure if an email digest is relevant to you, you can view an example by clicking the {{< ui >}}Example{{< /ui >}} link next to each email subscription. You can also use the {{< ui >}}Unsubscribe From All{{< /ui >}} button to unsubscribe from all email subscriptions.
{{% /site-region %}}


{{% site-region region="gov" %}}
You can manage your time zone, time format, and visual accessibility preference from the [**Preferences** tab][3] within the **Personal Settings** page.
You can manage your time zone, time format, and visual accessibility preference from the [**Preferences** tab][3] within the {{< ui >}}Personal Settings{{< /ui >}} page.
{{% /site-region %}}

#### Time format
Expand All @@ -66,11 +66,11 @@ The visual accessibility preference has five different settings to address color

### Organizations

The [Organizations tab][12] in **Personal Settings** lists all of the organizations you are associated with. Switch between these organizations from this page or by hovering over the account menu in the left-side navigation.
The [Organizations tab][12] in {{< ui >}}Personal Settings{{< /ui >}} lists all of the organizations you are associated with. Switch between these organizations from this page or by hovering over the account menu in the left-side navigation.

**Note**: If you leave an organization, you cannot rejoin unless invited by an administrator in that organization.

To join an existing organization, you must be invited by an administrator. After you are invited, you are sent an email with the subject "You've been invited to join \<Organization Name>". Click the **Join Account** button in the email.
To join an existing organization, you must be invited by an administrator. After you are invited, you are sent an email with the subject "You've been invited to join \<Organization Name>". Click the {{< ui >}}Join Account{{< /ui >}} button in the email.

If you are an organization administrator, reference the additional documentation to:

Expand All @@ -84,11 +84,11 @@ If you are an organization administrator, reference the additional documentation

#### Application keys

The [Application Keys tab][13] in **Personal Settings** allows you to manage your application keys. To copy a key, hover over it until the **Copy Key** icon appears to the right, and click on it. You can also click into a specific key to edit its name, view when it was created, view the profile of the key's owner, copy it, or revoke it.
The [Application Keys tab][13] in {{< ui >}}Personal Settings{{< /ui >}} allows you to manage your application keys. To copy a key, hover over it until the {{< ui >}}Copy Key{{< /ui >}} icon appears to the right, and click on it. You can also click into a specific key to edit its name, view when it was created, view the profile of the key's owner, copy it, or revoke it.

#### Apps

The [Apps tab][14] in **Personal Settings** allows you to manage apps that have been installed or created by members of your organization. You can filter apps with a search string, or choose to view only enabled or disabled apps using checkboxes.
The [Apps tab][14] in {{< ui >}}Personal Settings{{< /ui >}} allows you to manage apps that have been installed or created by members of your organization. You can filter apps with a search string, or choose to view only enabled or disabled apps using checkboxes.

When you hover over an app, the option to enable or disable it appears on the right of the app listing.

Expand All @@ -108,10 +108,10 @@ Unverified users can still access Datadog, but are limited to viewing organizati
#### Verify your email

To verify your email:
1. Navigate to your **Profile Settings**.
2. Click on **Verify Account**.
1. Navigate to your {{< ui >}}Profile Settings{{< /ui >}}.
2. Click on {{< ui >}}Verify Account{{< /ui >}}.
3. Enter the **verification code** sent to your registered email.
4. Click **Submit** to complete the verification process.
4. Click {{< ui >}}Submit{{< /ui >}} to complete the verification process.

#### Log out of all active web sessions

Expand All @@ -120,8 +120,8 @@ Logging out of all active web sessions logs you out of all current sessions acro


To log out of all active sessions:
1. Go to **Personal Settings**.
2. Click **Log Out of All Web Sessions**.
1. Go to {{< ui >}}Personal Settings{{< /ui >}}.
2. Click {{< ui >}}Log Out of All Web Sessions{{< /ui >}}.
3. Confirm the action.

After confirming, you are logged out from all devices and need to log back in.
Expand All @@ -130,7 +130,7 @@ After confirming, you are logged out from all devices and need to log back in.

View Datadog in dark mode by hovering over your avatar in the sidebar, or by pressing `Ctrl+Opt+D` / `Ctrl+Alt+D`.

To adapt to your computer's appearance setting, select the *System* option. This automatically matches Datadog's appearance to the theme you've set at the OS level.
To adapt to your computer's appearance setting, select the {{< ui >}}System{{< /ui >}} option. This automatically matches Datadog's appearance to the theme you've set at the OS level.

## Connecting to GitHub

Expand Down
14 changes: 7 additions & 7 deletions content/en/account_management/api-app-keys.md
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ In order to use application keys with these APIs, you must enable Actions API ac

{{< img src="account_management/click-enable-actions-api-access.png" alt="Click Enable for Actions API Access" style="width:80%;" >}}

**Note**: The **Last used** section only shows if [Audit Trail is enabled][22] in the account and you have [`Audit Trail Read`][23] permission.
**Note**: The {{< ui >}}Last used{{< /ui >}} section only shows if [Audit Trail is enabled][22] in the account and you have [`Audit Trail Read`][23] permission.

## Client tokens

Expand All @@ -70,7 +70,7 @@ For security reasons, API keys cannot be used to send data from a browser, mobil
- The log collectors for [web browser][8], [Android][9], [iOS][10], [React Native][11], [Flutter][12], and [Roku][13] submit logs.
- [Real User Monitoring][14] applications submit events and logs.

Client tokens are unique to your organization. To manage your client tokens, go to **Organization Settings**, then click the **Client Tokens** tab.
Client tokens are unique to your organization. To manage your client tokens, go to {{< ui >}}Organization Settings{{< /ui >}}, then click the {{< ui >}}Client Tokens{{< /ui >}} tab.

**Note**: When a user who created a client token is deactivated, the client token remains active.

Expand All @@ -79,9 +79,9 @@ Client tokens are unique to your organization. To manage your client tokens, go
To add a Datadog API key or client token:

1. Navigate to Organization settings, then click the [**API keys**][1] or [**Client Tokens**][15] tab.
2. Click the **New Key** or **New Client Token** button, depending on which you're creating.
2. Click the {{< ui >}}New Key{{< /ui >}} or {{< ui >}}New Client Token{{< /ui >}} button, depending on which you're creating.
3. Enter a name for your key or token.
4. Click **Create API key** or **Create Client Token**.
4. Click {{< ui >}}Create API key{{< /ui >}} or {{< ui >}}Create Client Token{{< /ui >}}.

{{< img src="account_management/api-key.png" alt="Navigate to the API Keys page for your organization in Datadog" style="width:80%;" >}}

Expand All @@ -92,11 +92,11 @@ To add a Datadog API key or client token:

## Remove API keys or client tokens

To remove a Datadog API key or client token, navigate to the list of keys or tokens, and click the **Delete** {{< img src="icons/delete.png" inline="true" style="width:14px;">}} icon next to the key or token you want to remove.
To remove a Datadog API key or client token, navigate to the list of keys or tokens, and click the {{< ui >}}Delete{{< /ui >}} {{< img src="icons/delete.png" inline="true" style="width:14px;">}} icon next to the key or token you want to remove.

## Add application keys

To add a Datadog application key, navigate to [**Organization Settings** > **Application Keys**][2]. If you have the [permission][3] to create application keys, click **New Key**.
To add a Datadog application key, navigate to [**Organization Settings** > **Application Keys**][2]. If you have the [permission][3] to create application keys, click {{< ui >}}New Key{{< /ui >}}.

{{< img src="account_management/app-key.png" alt="Navigate to the Application Keys page for your organization in Datadog" style="width:80%;" >}}

Expand All @@ -112,7 +112,7 @@ To add a Datadog application key, navigate to [**Organization Settings** > **App

## Remove application keys

To remove a Datadog application key, navigate to [**Organization Settings** > **Application Keys**][2]. If you have the [permission][3] to create and manage application keys, you can see your own keys and click **Revoke** next to the key you want to revoke. If you have the permission to manage all org application keys, you can search for the key you want to revoke and click **Revoke** next to it.
To remove a Datadog application key, navigate to [**Organization Settings** > **Application Keys**][2]. If you have the [permission][3] to create and manage application keys, you can see your own keys and click {{< ui >}}Revoke{{< /ui >}} next to the key you want to revoke. If you have the permission to manage all org application keys, you can search for the key you want to revoke and click {{< ui >}}Revoke{{< /ui >}} next to it.

## Key propagation delay and eventual consistency

Expand Down
34 changes: 17 additions & 17 deletions content/en/account_management/audit_trail/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ You can also analyze Audit Trail events with [Cloud SIEM][15] to detect threats

## Setup

To enable Datadog Audit Trail, navigate to your [Organization Settings][3] and select *Audit Trail Settings* under *COMPLIANCE*. Click the **Enable** button.
To enable Datadog Audit Trail, navigate to your [Organization Settings][3] and select {{< ui >}}Audit Trail Settings{{< /ui >}} under {{< ui >}}COMPLIANCE{{< /ui >}}. Click the {{< ui >}}Enable{{< /ui >}} button.

{{< img src="account_management/audit_logs/audit_trail_settings.png" alt="The Audit Trail Settings page showing it disabled" style="width:85%;">}}

Expand All @@ -68,11 +68,11 @@ Only users with `Audit Trail Write` permission can enable or disable Audit Trail

Archiving is an optional feature for Audit Trail. You can use archiving to write to Amazon S3, Google Cloud Storage, or Azure Storage and have your SIEM system read events from it. After creating or updating your archive configurations, it can take several minutes before the next archive upload is attempted. Events are uploaded to the archive every 15 minutes, so check back on your storage bucket in 15 minutes to make sure the archives are successfully being uploaded from your Datadog account.

To enable archiving for Audit Trail, navigate to your [Organization Settings][3] and select *Audit Trail Settings* under *Compliance*. Scroll down to Archiving and click the Store Events toggle to enable.
To enable archiving for Audit Trail, navigate to your [Organization Settings][3] and select {{< ui >}}Audit Trail Settings{{< /ui >}} under {{< ui >}}Compliance{{< /ui >}}. Scroll down to Archiving and click the {{< ui >}}Store Events{{< /ui >}} toggle to enable.

### Retention

Retaining events is an optional feature for Audit Trail. In the **Retention Period** section, click the **Change retention period** to select a retention length appropriate for your use case.
Retaining events is an optional feature for Audit Trail. In the {{< ui >}}Retention Period{{< /ui >}} section, click the {{< ui >}}Change retention period{{< /ui >}} to select a retention length appropriate for your use case.

When Audit Trail is enabled, the default retention period for an audit trail event is 90 days. You can set the retention period to: 3, 7, 15, 30, or 90 days.

Expand Down Expand Up @@ -115,16 +115,16 @@ Efficient troubleshooting requires your data to be in the proper scope to permit

All saved views, that are not your default view, are shared across your organization:

* **Integration saved views** come out-of-the-box with Audit Trail. These views are read-only, and identified by the Datadog logo.
* **Custom saved views** are created by users. They are editable by any user in your organization (except [read only users][6]), and identified with the avatar of the user who created them Click the **Save** button to create a new custom saved view from the current content of your explorer.
* {{< ui >}}Integration saved views{{< /ui >}} come out-of-the-box with Audit Trail. These views are read-only, and identified by the Datadog logo.
* {{< ui >}}Custom saved views{{< /ui >}} are created by users. They are editable by any user in your organization (except [read only users][6]), and identified with the avatar of the user who created them Click the {{< ui >}}Save{{< /ui >}} button to create a new custom saved view from the current content of your explorer.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* {{< ui >}}Custom saved views{{< /ui >}} are created by users. They are editable by any user in your organization (except [read only users][6]), and identified with the avatar of the user who created them Click the {{< ui >}}Save{{< /ui >}} button to create a new custom saved view from the current content of your explorer.
* {{< ui >}}Custom saved views{{< /ui >}} are created by users. They are editable by any user in your organization (except [read only users][6]), and identified with the avatar of the user who created them. Click the {{< ui >}}Save{{< /ui >}} button to create a new custom saved view from the current content of your explorer.


At any moment, from the saved view entry in the Views panel:

* **Load** or **reload** a saved view.
* **Update** a saved view with the configuration of the current view.
* **Rename** or **delete** a saved view.
* **Share** a saved view through a short-link.
* **Star** (turn into a favorite) a saved view so that it appears on top of your saved view list, and is accessible directly from the navigation menu.
* {{< ui >}}Load{{< /ui >}} or {{< ui >}}reload{{< /ui >}} a saved view.
* {{< ui >}}Update{{< /ui >}} a saved view with the configuration of the current view.
* {{< ui >}}Rename{{< /ui >}} or {{< ui >}}delete{{< /ui >}} a saved view.
* {{< ui >}}Share{{< /ui >}} a saved view through a short-link.
* {{< ui >}}Star{{< /ui >}} (turn into a favorite) a saved view so that it appears on top of your saved view list, and is accessible directly from the navigation menu.

**Note:** Update, rename, and delete actions are disabled for integration saved views and [read only users][6].

Expand All @@ -139,9 +139,9 @@ Your existing Audit Trail explorer view is your default saved view. This configu

At any moment, from the default view entry in the Views panel:

* **Reload** your default view by clicking on the entry.
* **Update** your default view with the current parameters.
* **Reset** your default view to Datadog's defaults for a fresh restart.
* {{< ui >}}Reload{{< /ui >}} your default view by clicking on the entry.
* {{< ui >}}Update{{< /ui >}} your default view with the current parameters.
* {{< ui >}}Reset{{< /ui >}} your default view to Datadog's defaults for a fresh restart.

### Notable Events

Expand Down Expand Up @@ -176,7 +176,7 @@ The Inspect Changes (Diff) tab in the audit event details panel compares the con

Reference Tables allow you to combine metadata with audit events, providing more information to investigate Datadog user behavior. Add a query filter based on a Reference Table to perform lookup queries. For more information on activating and managing this feature, see the [Reference Tables][2] guide.

To apply a query filter with Reference Tables, click on the `+ Add` button next to the query editor and select **Join with Reference Table**. In the following example, the Reference Table query filter is used to search for dashboards modified by users who are accessing Datadog from non-authorized IP addresses:
To apply a query filter with Reference Tables, click on the {{< ui >}}+ Add{{< /ui >}} button next to the query editor and select {{< ui >}}Join with Reference Table{{< /ui >}}. In the following example, the Reference Table query filter is used to search for dashboards modified by users who are accessing Datadog from non-authorized IP addresses:

{{< img src="account_management/audit_logs/reference_tables.png" alt="The Datadog Audit Trail explorer with reference table search options highlighted" border="true" popup="true" style="width:100%;" >}}

Expand Down Expand Up @@ -207,9 +207,9 @@ You can save your Audit Trail query as a dashboard and send out a scheduled repo
To create a scheduled report:

1. Navigate to [Audit Trail][1], enter your query to filter your audit events.
1. Click **More** and select **Save to dashboard**.
1. Click {{< ui >}}More{{< /ui >}} and select {{< ui >}}Save to dashboard{{< /ui >}}.
- You can either save to an existing dashboard or create a new dashboard.
1. On your dashboard, click **Share** and select **Schedule report**.
1. On your dashboard, click {{< ui >}}Share{{< /ui >}} and select {{< ui >}}Schedule report{{< /ui >}}.
1. Follow the instructions in [Schedule a Report][17] to set up your report.

## Download Audit Events as CSV
Expand All @@ -219,7 +219,7 @@ Datadog Audit Trail allows you to download up to 100K audit events as a CSV file
To export audit events as CSV:
1. Run the appropriate search query that captures the events you are interested in
2. Add event fields as columns in the view that you want as part of CSV
3. Click on Download as CSV
3. Click on {{< ui >}}Download as CSV{{< /ui >}}
4. Select the number of events to export and export as CSV

## Out-of-the-box dashboard
Expand Down
Loading
Loading