Oracle Cloud Infrastructure Documentation

Fleets in Fleet Application Management

A fleet in Fleet Application Management is a collection or grouping of resources based on criteria. You can define the criteria during fleet creation.

When you create a fleet, Fleet Application Management attaches relevant tagging information to the resources within fleets, if Tagging is enabled during the Fleet Application Management onboarding process. The tagging information helps you draw inferences about cost tracking, budgeting, logging, and auditing. Also, tagging information helps organize and search resources. To learn more about Tagging, see Overview of Tagging. For an example of how Tagging information in Fleet Application Management can help, see Examples of Using Tagging Information.

See the following fleet management tasks:

Fleet States

A fleet can have the following states in Fleet Application Management:
  • CREATING: The fleet is being created. When a fleet is in this state, you can't update or delete it. Wait till the fleet reaches the ACTIVE or FAILED state before you try to modify it or delete it.
  • VALIDATING: The fleet's resources are being validated. After successful validation, the fleet moves to the DISCOVERING state. If validation fails, the fleet moves to either the FAILED state or the NEED_ATTENTION state, and you're prompted to retry validating the fleet resources. See Validating a Fleet.
  • DISCOVERING: The fleet's resource targets are being discovered. After successful discovery, the fleet is moved to the ACTIVE state. If discovery fails, the fleet is moved to the FAILED state, and you're prompted to retry discovering the fleet resource targets. See Retrying Target Discovery.
  • UPDATING: The fleet's settings are being updated, resources are being added, discovery is reprocessing, or the fleet is being validated. The fleet isn't available for modification in this state. It moves back to the ACTIVE state after the update, or it might move to the FAILED state.
  • ACTIVE: The fleet is active and available for lifecycle operations. When a fleet is in this state, you can modify or delete it.
  • NEED_ATTENTION: The fleet's resource validation fails because OCI Compute or Oracle Database resource prerequisites aren't met. See Prerequisites. Also, it's in this state when target discovery fails or is complete and requests confirmation of targets. You must confirm the targets manually because the fleet is in REVIEW PENDING state.
    Note

    The fleet's targets need confirmation when the discovery of these resource targets is unsuccessful or you didn't automatically confirm them during fleet creation.
  • FAILED: A fleet action has failed and the fleet can't be used.
  • DELETING: The fleet is being deleted. You can't modify it.
  • DELETED: The fleet has been deleted. You can't modify it. Fleet Application Management removes deleted fleets after some time.
Fleet resources can have the following states:
  • VALIDATING: The fleet resources are being validated.
  • VALIDATED: The fleet resources were successfully validated.
  • INVALID: The fleet resources can't be validated, are stopped, or can't be identified.

Examples of Using Tagging Information

The following examples explain how Tagging information can be helpful for budgeting, tracking spending and costs, searching logs, and checking audit logs in your tenancy.

Suppose you create a product-type fleet with the fleet name, MyProductFleet. If Tagging was enabled during the Fleet Application Management onboarding process, Fleet Application Management adds the following defined tags to fleet resources using the Oracle$FAMS-Tags namespace:

  • Oracle$FAMS-Tags.FleetName: MyProductFleet
  • Oracle$FAMS-Tags.FAMSManaged: Y

Create a Budget

Create a budget by using Oracle$FAMS-Tags and review it.

  1. Open the navigation menu  and select Billing & Cost Management. Under Cost Management, select Budgets.
  2. On the Budgets page, click Create Budget.
  3. For Budget Scope, select Cost-tracking Tag.
  4. Enter a name for the budget, for example, FAMSManagedFleets.
  5. Enter a description for the budget, for example, Budget monitoring for FAMSManagedFleets. Avoid entering confidential information.
  6. For budgets that target a cost-tracking tag:
    1. Select a tag namespace, for example, Oracle$FAMS-Tags.
    2. Select a target cost-tracking tag key, for example, FAMSManaged.
    3. Enter a value for the cost-tracking tag, for example, Y.
  7. Under Schedule, select Monthly for a recurring budget.
    1. In the Budget Amount field, enter a monthly amount for the budget.
    2. In Day of the month to begin budget processing, select a day of the month when you want budget processing to start periodically each month, for example, 1.
  8. Click Create.
To learn more about OCI budgeting and managing budgets, see Budgets Overview.

Track Spending

Track your OCI spending by using cost analysis to view the chart data items using Oracle$FAMS-Tags.

  1. Open the navigation menu  and select Billing & Cost Management. Under Cost Management, select Cost Analysis.
  2. From Start/End Date (UTC), select a time period, for example, Aug 1 through Aug 7.
  3. From Granularity, select Daily.
  4. From Show, select Cost.
  5. From Filters, select a filter such as Tag: Oracle$FAMS-Tags.FAMSManaged: Y.
  6. From Grouping dimensions, select Service.
  7. To apply the changes and reload the chart and table with the selected filters, click Apply.
You can save the filtered data as a report that you can view later alongside the predefined reports. See Saving Reports. You can also download the cost details data for further investigation. See Downloading your Cost Details Data. For more information about the cost analysis tool, see Cost Analysis Overview.

Search Logs

Search logs by using the Logging Search page with Oracle$FAMS-Tags.

  1. Open the navigation menu and click Observability & Management. Under Logging, click Search.
  2. In Custom filters, start typing to display filter settings along with operators. For example: data.definedTags={"FAMSManaged":"Y","FleetName":"MyProductFleet"},"Oracle-Tags":
  3. In Select logs to search, ensure that the compartment is the one from which the resources are added to a fleet. The root compartment is selected by default for filtering.
The logging data in the Explore and Visualize tabs is reloaded according to the filter settings, or you can click Search to apply the filter. To learn more about searching logs using the Logging Search page, see Logging Search.

Check Audit Logs

Explore audit logs using Oracle$FAMS-Tags.

  1. Open the navigation menu  and select Observability & Management. Under Logging, select Audit.
    The list of audit logs for the current compartment is displayed.
  2. Select a compartment from which the resources are added to a fleet.
  3. In Custom filters, start typing to display filter settings along with operators. For example: data.definedTags={"Oracle$FAMS-Tags":{"FAMSManaged":Y","FleetName":"MyProductFleet"},"Oracle-Tags"}}
  4. Click Apply.
For more information about audit logs, see Audit Logs.