Oracle Cloud Infrastructure Documentation

Implementing Cloud Advisor Recommendations

This section describes how to implement recommendations using fix-it flows in Cloud Advisor.

Note

For manual implementation instructions, see the related recommendation at Cloud Advisor Categories and Recommendations.

Required IAM Policies

To use Oracle Cloud Infrastructure, you must be granted security access in a policy  by an administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don’t have permission or are unauthorized, verify with your administrator what type of access you have and which compartment  to work in.

To get started with Cloud Advisor, an administrator must grant each user access to Cloud Advisor and to the resources that Cloud Advisor recommendations impact through an IAM policy. Each service in Oracle Cloud Infrastructure integrates with IAM for authentication and authorization, for all interfaces (the Console, SDK or CLI, and REST API).

The resource name for Cloud Advisor is optimizer-api-family. The following is an example policy to grant users access to Cloud Advisor to the resources that Cloud Advisor recommendations impact:

Allow group OptimizerAdmins to manage optimizer-api-family in tenancy

If you're new to policies, see Getting Started with Policies and Common Policies. For more information about Cloud Advisor policies, see Policy Details for Cloud Advisor.

Resource Actions

Learn how to view and update resource actions.

Listing Resource Actions

Using the CLI

Use the oci optimizer resource-action-summary list command to list resource actions.

oci optimizer resource-action-summary list --compartment-id <compartment_ocid> --resource-action-id <resource_action_ocid>

For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

Getting Resource Actions

Updating Resource Actions

Update resource actions to postpone or dismiss a recommendation for a single resource.

Using the CLI

Use the oci optimizer resource-action update command to update resource actions.

oci optimizer resource-action update --resource-action-id <resource_action_ocid> --status <status>

For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

Recommendations

Learn how to implement and update recommendations.

Implementing Recommendations

Using the Console

  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Recommendations.
    The Cloud Advisor Recommendations dashboard opens.
  2. Click the name of the recommendation that you want to implement.
    The recommendation details panel opens and displays the list of resources that this recommendation applies to.
  3. Select one or more resources.
  4. Click Implement selected.
    A panel opens with more details about the recommendation and the list of resources impacted by the changes.
  5. Follow the fix-it flow.

    When you complete the fix-it flow, the work request panel opens.

    The recommendation status changes from Pending to Implemented when the work request is complete.

  6. To close the panel, click Close.

Updating Recommendations

Update a recommendation to dismiss, postpone, reactivate, or edit the recommendation for one or more resources.

Using the Console

To dismiss a recommendation for specific resources
  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Recommendations.
    The Cloud Advisor Recommendations dashboard opens.
  2. Click the recommendation in the list to open the recommendation details panel. A list of individual resources with pending recommendations displays.
  3. Select the resources that you want to dismiss, and then click Dismiss selected.
  4. In the Dismiss recommendation panel, click Dismiss.
    The recommendation now has the status Dismissed for the selected resources. Dismissed recommendations are removed from the default view of the dashboard. You can view them again by filtering the list for the Dismissed status.
To postpone a recommendation for specific resources
  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Recommendations.
    The Cloud Advisor Recommendations dashboard opens.
  2. Click the recommendation in the list to open the recommendation details panel. A list of individual resources with pending recommendations displays.
  3. Select the resources for which you want to postpone recommendations, and then click Postpone selected.
  4. In the Postpone recommendations panel, for Select date, use the calendar picker to select a date when the recommendation reactivates, and then click Postpone.
    The recommendation now has the status Postponed for the selected resources. On the selected date, the recommendation will change to the status Active for the selected resources.
To edit recommendation postponements for resources
Change the date that a postponed recommendation reactivates for specific resources by editing the postponement.
  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Recommendations.
    The Cloud Advisor Recommendations dashboard opens.
  2. Click the recommendation in the list to open the recommendation details panel. A list of individual resources with pending recommendations displays.
  3. In the Cloud Advisor status menu, click Postponed. The list of resources whose recommendations have been postponed opens.
  4. Find the resources whose postponement you want to edit, click the Actions icon (Actions icon), and then click Edit postponement.
  5. In the Edit postponement panel, for Select date, use the calendar picker to select a date when the recommendation reactivates, and then click Save.
    The recommendation continues to have the status Postponed for the selected resources. On the selected date, the recommendation will change to the status Active for the selected resources.
To reactivate a recommendation for specific resources
  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Recommendations.
    The Cloud Advisor Recommendations dashboard opens.
  2. Click the recommendation that has postponed or dismissed resources to open the recommendation details page.
  3. In the Cloud Advisor status menu, click Dismissed or Postponed, depending on whether the recommendation that you want to reactivate was dismissed or postponed.
  4. In the list, select the resources that you want to reactivate, and then click Reactivate selected.
  5. In the Reactivate selected resources panel, click Reactivate.
    The recommendation now has the status Active for the selected resources.
To dismiss a recommendation for all resources
  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Recommendations.
    The Cloud Advisor Recommendations dashboard opens.
  2. In the list, for the recommendation that you want to dismiss, click the Actions icon (Actions icon), and then click Dismiss.
  3. In the Dismiss recommendation panel, click Dismiss. The recommendation is dismissed for all associated resources.
    The recommendation now has the status Dismissed for all resources. Dismissed recommendations are removed from the default view of the dashboard. You can view them again by filtering the list for the Dismissed status.
To postpone a recommendation for all resources
  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Recommendations.
    The Cloud Advisor Recommendations dashboard opens.
  2. In the list, for the recommendation that you want to postpone, click the Actions icon (Actions icon), and then click Postpone.
  3. In the Postpone recommendation dialog, for Select date, use the calendar picker to select a date when the recommendation reactivates, and then click Postpone.
    The recommendation now has the status Postponed for all resources. On the selected date, the recommendation will change to the status Active for all resources.
To reactivate a recommendation
  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Recommendations.
    The Cloud Advisor Recommendations dashboard opens.
  2. In the Status menu, click Dismissed or Postponed, depending on whether the recommendation that you want to reactivate was dismissed or postponed.
  3. In the list, for the recommendation that you want to reactivate, click the Actions icon (Actions icon), and then click Reactivate.
  4. In the Reactivate recommendation panel, click Reactivate.
    The recommendation now has the status Active for all resources.

History

Learn how to view history (recommendation status changes).

Listing History (Recommendation Status Changes)

Using the Console

  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click History.
    The Cloud Advisor History dashboard opens. This page tracks recommendation status changes. For example, it lists information about recommendations that have been implemented, postponed, and dismissed.
  2. (Optional) Use one or more of the following filters to return a subset of results.
    • Filter by resource type
    • Filter by Cloud Advisor status
    • Filter by recommendation

Using the API

Use the ListHistories operation to list user changes to recommendations.

Work Requests

Learn how to view work requests, including details, errors, and logs.

Listing Work Requests

Using the Console

Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Work Requests.

Getting Work Request Details

Using the Console

  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Work Requests.
  2. Click the name of the work request you want.
    The details page for the selected work request opens. Log messages, error messages, and associated resources are listed.

Using the API

Use the GetWorkRequest operation to get work requests.

Listing Work Request Errors

Using the Console

  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Work Requests.
  2. Click the name of the work request you want.
    The details page for the selected work request opens. Log messages, error messages, and associated resources are listed.
  3. Under Resources, click Error messages.
    The text, error code, and timestamp are listed for each error message.

Listing Work Request Logs

Using the Console

  1. Open the navigation menu and click Governance & Administration. Under Cloud Advisor, click Work Requests.
  2. Click the name of the work request you want.
    The details page for the selected work request opens. Log messages, error messages, and associated resources are listed.
  3. Under Resources, click Log messages.
    The text and timestamp are listed for each log message.

Recommendation Strategies

Learn how to view recommendation strategies.