Skip to content

Latest commit

 

History

History

oracle_cbi

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
CHANGELOG.md
CHANGELOG.md
 
 
README.md
README.md
 
 
oracle_cbi.pt
oracle_cbi.pt
 
 

README.md

Oracle Cloud Common Bill Ingestion

What It Does

This Policy Template is used to automatically take Cost Reports from Oracle Cloud (OCI) and send them to Flexera CBI so that Oracle Cloud costs are visible in Flexera One. An incident is raised on every execution of the policy to provide status information to the user.

How It Works

  • The policy uses the Oracle Cloud Object Storage API to connect to the bucket containing the Cost & Usage Reports and obtain the relevant reports for the specified month (or current month if none is specified.)
  • The policy then sends those reports, unmodified, into a Flexera CBI endpoint so that they can be ingested and then visible on the platform.
  • The policy does this over the course of multiple runs to avoid hitting memory and other constraints. It is recommended that the default frequency of 15 minutes be used; the policy may not function correctly or as expected if a longer frequency is selected.
  • The policy requires that a valid Oracle CBI endpoint exists, a valid Oracle Cloud credential exists in Flexera One, and that Cost & Usage Reporting is enabled in Oracle Cloud.
  • It is recommended that this policy be applied twice, with Month To Ingest set to Current Month for one instance and with it set to Previous Month for the other. This is to ensure that any changes made to Oracle billing data after the month ends are brought into the Flexera platform.

Input Parameters

This policy has the following input parameters required when launching the policy.

  • Month To Ingest - Whether to process bills for the current month, previous month, or a specific month.
  • Billing Period - The year and month to process bills for in YYYY-MM format. Only relevant if Specific Month is selected for the Month To Ingest parameter. Example: 2022-09
  • Flexera CBI Endpoint - The name of the Flexera CBI endpoint to use. Example: cbi-oi-oracle-oraclecloud
  • Oracle Cloud Region - The region of the Oracle Cloud Object Storage bucket containing the cost and usage reports. Example: us-phoenix-1
  • Oracle Cloud Cost & Usage Bucket - OCID of the Oracle Cloud Object Storage bucket containing the Cost and Usage reports.
  • Block Size - The number of files to upload with each execution of the policy. The default value of 20 is recommended.
  • Commit Delay (Hours) - The number of hours to wait between committing bill uploads. This is to avoid overloading the CBI system and to ensure bill ingestion occurs at a predictable cadence. The default value of 12 is recommended.

Policy Actions

  • Upload Oracle Cloud bills to Flexera Cloud Cost Optimization (CCO)

Prerequisites

This Policy Template uses Credentials for authenticating to datasources -- in order to apply this policy you must have a Credential registered in the system that is compatible with this policy. If there are no Credentials listed when you apply the policy, please contact your Flexera Org Admin and ask them to register a Credential that is compatible with this policy. The information below should be consulted when creating the credential(s).

  • Flexera Credential (provider=flexera) which has the following roles:

    • org_owner

  • Oracle Credential (provider=oracle) which meets the below requirements:

    • define tenancy usage-report as [OCID]
      • [OCID] should be replaced with the OCID shown on the Cost & Usage Reports page in Oracle Cloud's web UI. [Group] should be replaced with a group that the user associated with the Oracle Cloud credential is a member of.
    • endorse group [Group] to read objects in tenancy usage-report

Note: Oracle Cloud credentials cannot be added in Flexera One; the Flexera Credential Management API must be used to create the credential.

The Provider-Specific Credentials page in the docs has detailed instructions for setting up Credentials for the most common providers.

Additional Requirements

This policy also requires a valid Oracle CBI endpoint created using the Flexera Bill Connect API, as well as Cost & Usage Reporting to be enabled within the Oracle Cloud environment.

Additionally, the policy requires that the Flexera Bill Upload limit be increased to 125 on your Flexera One organization. Please contact Flexera Support to have this done.

Supported Clouds

  • Oracle Cloud (OCI)

Cost

This policy template does not incur any cloud costs.