docs: nav updates for various admin topics (#64988)

* navigation related updates

* fix typos

* removed manual navigation to home section and updated intro text for changing default dashboard
This commit is contained in:
Isabel
2023-03-20 13:43:22 -04:00
committed by GitHub
parent 93bcc3b26c
commit 70116dc65f
3 changed files with 55 additions and 65 deletions

View File

@ -69,14 +69,14 @@ Note that the user who created a service account will also be able to read, upda
### To create a service account
1. Sign in to Grafana and hover your cursor over the Configuration (cog) icon in the sidebar.
1. Sign in to Grafana and click **Administration** in the left-side menu.
1. Click **Service accounts**.
1. Click **New service account**.
1. Click **Add service account** .
1. Enter a **Display name**.
1. The display name must be unique as it determines the ID associated with the service account.
- We recommend that you use a consistent naming convention when you name service accounts. A consistent naming convention can help you scale and maintain service accounts in the future.
- You can change the display name at any time.
1. Click **Create service account**.
1. Click **Create**.
## Add a token to a service account in Grafana
@ -94,15 +94,15 @@ By default, service account tokens don't have an expiration date, meaning they w
### To add a token to a service account
1. Sign in to Grafana, then hover your cursor over **Configuration** (the gear icon) in the sidebar.
1. Sign in to Grafana and click **Administration** in the left-side menu.
1. Click **Service accounts**.
1. Click the service account to which you want to add a token.
1. Click **Add token**.
1. Click **Add service account token**.
1. Enter a name for the token.
1. (recommended) Enter an expiry date and expiry date for the token or leave it on no expiry date option.
1. (recommended) Select **Set expiration date** and enter an expiry date for the token.
- The expiry date specifies how long you want the key to be valid.
- If you are unsure of an expiration date, we recommend that you set the token to expire after a short time, such as a few hours or less. This limits the risk associated with a token that is valid for a long time.
1. Click **Generate service account token**.
1. Click **Generate token**.
## Assign roles to a service account in Grafana
@ -117,11 +117,10 @@ In [Grafana Enterprise]({{< relref "../../introduction/grafana-enterprise/" >}})
### To assign a role to a service account
1. Sign in to Grafana, then hover your cursor over **Configuration** (the gear icon) in the sidebar.
1. Sign in to Grafana and click **Administration** in the left-side menu.
1. Click **Service accounts**.
1. Click the service account to which you want to assign a role. As an alternative, find the service account in the list view.
1. Assign a role using the role picker.
1. Click **Update**.
1. Assign a role using the role picker to update.
## Manage users and teams permissions for a service account in Grafana
@ -141,19 +140,19 @@ You can assign on of the following permissions to a specific user or a team:
### To update team permissions for a service account
1. Sign in to Grafana, then hover your cursor over **Configuration** (the gear icon) in the sidebar.
1. Sign in to Grafana and click **Administration** in the left-side menu.
1. Click **Service accounts**.
1. Click the service account for which you want to update team permissions a role.
1. In the **Permissions** section at the bottom, click **Add permission**.
1. In the Permissions section at the bottom, click **Add permission**.
1. Choose **Team** in the dropdown and select your desired team.
1. Choose **View**, **Edit** or **Admin** role in the dropdown and click **Save**.
### To update user permissions for a service account
1. Sign in to Grafana, then hover your cursor over **Configuration** (the gear icon) in the sidebar.
1. Sign in to Grafana and click **Administration** in the left-side menu.
1. Click **Service accounts**.
1. Click the service account for which you want to update team permissions a role.
1. In the **Permissions** section at the bottom, click **Add permission**.
1. In the Permissions section at the bottom, click **Add permission**.
1. Choose **User** in the dropdown and select your desired user.
1. Choose **View**, **Edit** or **Admin** role in the dropdown and click **Save**.