Skip to content

Commit

Permalink
Merge pull request #963 from wavefrontHQ/mstaneva-CSP-feedback
Browse files Browse the repository at this point in the history
Some fixes to the language
  • Loading branch information
Margarita-Staneva authored Sep 29, 2023
2 parents f02e8e7 + 84cba2a commit a3641f8
Show file tree
Hide file tree
Showing 4 changed files with 8 additions and 8 deletions.
5 changes: 1 addition & 4 deletions pages/doc/csp_api_tokens.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,10 +66,7 @@ For details on how to create, view, and modify the details of the OAuth 2.0 apps

If you want to set up one of the [integrations](integrations_onboarded_subscriptions.html#integrations-that-use-operations-for-applications-api-tokens) that still authenticate with an **Operations for Applications API token**, you must create a [service account](csp_service_accounts.html) and generate an API token associated with it.

{% include important.html content="Service accounts are enabled only for a **limited number** of VMware Cloud services subscriptions, because The usage of service accounts in Operations for Applications on VMware Cloud services is **restricted** to support only a [limited list of integrations](integrations_onboarded_subscriptions.html#integrations-that-use-operations-for-applications-api-tokens) that still authenticate with Operations for Applications API tokens. We are in the process of updating all of our integrations to authenticate with VMware Cloud services access tokens. Service accounts and Operations for Applications API tokens will be deprecated in the future. To enable service accounts for your service instance, [contact](wavefront_support_feedback.html) our Technical Support team. "%}

{% include warning.html content=" Service accounts are enabled only for a **limited number** of VMware Cloud services subscriptions. It is strongly recommended that you gradually [switch to using server to server OAuth apps](csp_migration.html#how-to-replace-a-service-account-with-a-server-to-server-app) which authenticate with more secure VMware Cloud services access tokens. Service accounts and Operations for Applications API tokens will be deprecated in the future. Тo temporarily enable service accounts for your service instance, [contact](wavefront_support_feedback.html) our Technical Support team." %}

{% include warning.html content="The usage of service accounts in Operations for Applications on VMware Cloud services is **restricted** to support only a [limited list of integrations](integrations_onboarded_subscriptions.html#integrations-that-use-operations-for-applications-api-tokens) that still authenticate with Operations for Applications API tokens. We are in the process of updating all of our integrations to authenticate with VMware Cloud services access tokens. It is strongly recommended that you gradually [switch to using server to server OAuth apps](csp_migration.html#how-to-replace-a-service-account-with-a-server-to-server-app) which authenticate with more secure VMware Cloud services access tokens. Service accounts and Operations for Applications API tokens will be deprecated in the future. Тo temporarily enable service accounts for your service instance, [contact](wavefront_support_feedback.html) our Technical Support team. "%}

As a user with the **Admin** service role, you can generate and manage the API tokens for [service accounts](csp_service_accounts.html) upon creation or at a later stage.

Expand Down
2 changes: 1 addition & 1 deletion pages/doc/csp_area_differences.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Some administrative tasks, done by **Super Admins** and users with the **Account

With the 2023-38 release, we introduce the **Admin** permission and service role, which partially correspond to the **Accounts** permission for original subscriptions. Users with the **Admin** service role can manage service accounts and Operations for Applications API tokens. They can also restrict access to new dashboards and alerts and set the organization settings. For example, they can restrict the access to the object creator only and set default settings, such as display settings, PromQL support, default way of building queries, and define Logs settings.

{% include warning.html content="Service accounts are enabled only for a **limited number** of VMware Cloud services subscriptions.Service accounts and the API tokens associated with them will be deprecated in the future. It's strongly recommended that you incrementally switch to using [server to server OAuth apps](csp_server_to_server_apps.html) which authenticate with more secure VMware Cloud services access tokens. For information on how to do this, see [How to Replace a Service Account with a Server to Server App?](csp_migration.html#how-to-replace-a-service-account-with-a-server-to-server-app). To temporarily enable service accounts for your service instance, [contact](wavefront_support_feedback.html) our Technical Support team." %}
{% include warning.html content="Service accounts are enabled only for a **limited number** of VMware Cloud services subscriptions. Service accounts and the API tokens associated with them will be deprecated in the future. It's strongly recommended that you incrementally switch to using [server to server OAuth apps](csp_server_to_server_apps.html) which authenticate with more secure VMware Cloud services access tokens. For information on how to do this, see [How to Replace a Service Account with a Server to Server App?](csp_migration.html#how-to-replace-a-service-account-with-a-server-to-server-app). To temporarily enable service accounts for your service instance, [contact](wavefront_support_feedback.html) our Technical Support team." %}

![A graphic showing the differences in the admin tasks for original and onboarded subscriptions. The information displayed is described in the table below.](images/csp-admin-tasks.png)

Expand Down
6 changes: 4 additions & 2 deletions pages/doc/wavefront_api_usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,10 @@ If you want to use [your own user account](csp_users_account_managing.html) to m

1. Go to the [Authentication VMware Cloud services APIs](https://console.cloud.vmware.com/csp/gateway/authn/api/swagger-ui.html#/Authentication/getAccessTokenByApiRefreshTokenUsingPOST).
2. In the `POST/am/api/auth/api-tokens/authorize` request, click **Try it out**.
3. For the **api_token** parameter, enter the value of the newly generated API token, and click **Execute**.
4. From the response body, copy the value of the `"access_token"` parameter.
3. For the **api_token** parameter, enter the value of the newly generated API token.
4. Deselect the **Send empty value** check box for the **passcode** parameter.
5. Click **Execute**.
6. From the response body, copy the value of the `"access_token"` parameter.

4. If you use `curl`, and want to get information about all cloud integrations in your environment, run:

Expand Down
3 changes: 2 additions & 1 deletion pages/doc/wavefront_monitoring_spy.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,13 +15,14 @@ VMware Aria Operations for Applications (formerly known as Tanzu Observability b

Use spy to extract information programmatically. This page gives details on the available endpoints and associated parameters.

Use Wavefront top if you want a keyboard-driven UI that's similar to the Linux top UI. The tool is open source and on [GitHub](https://github.com/wavefrontHQ/wftop). You can also read [the blog that Joanna prepared](https://tanzu.vmware.com/content/vmware-tanzu-observability-blog/monitor-and-optimize-data-ingestion-by-wavefront-across-your-organization-introducing-wavefront-top), or watch a short video. Note that this video was created in 2019 and some of the information in it might have changed. It also uses the 2019 version of the UI.
Use Wavefront top if you want a keyboard-driven UI that's similar to the Linux top UI. The tool is open source and on [GitHub](https://github.com/wavefrontHQ/wftop). You can also read [the blog that Joanna prepared](https://tanzu.vmware.com/content/vmware-tanzu-observability-blog/monitor-and-optimize-data-ingestion-by-wavefront-across-your-organization-introducing-wavefront-top).Note that this video was created in 2019 and some of the information in it might have changed. It also uses the 2019 version of the UI.

<iframe id="kmsembed-1_yif61rd5" width="708" height="402" src="https://vmwaretv.vmware.com/embed/secure/iframe/entryId/1_yif61rd5/uiConfId/49694343/pbc/252649793/st/0" class="kmsembed" allowfullscreen webkitallowfullscreen mozAllowFullScreen allow="autoplay *; fullscreen *; encrypted-media *" referrerPolicy="no-referrer-when-downgrade" frameborder="0" title="Using Wavefront Top"></iframe>


You can also watch the video <a href="https://vmwaretv.vmware.com/media/t/1_yif61rd5" target="_blank">here <img src="/images/video_camera.png" alt="video camera icon"/></a>.

To set up the Wavefront top utility you need a valid API token. For an Operations for Applications subscription on VMware Cloud services, you must use a VMware Cloud services access token. To get an access token, generate a VMware Cloud services API token associated with your user account and exchange it for the access token. Make sure that when you do this, you deselect the **Send empty value** check box for the **passcode** parameter. For more information and instructions, see [Use the Operations for Applications REST API](using_wavefront_api.html).


## Why Spy?
Expand Down

0 comments on commit a3641f8

Please sign in to comment.