Choose how the data reaches us
CostGraph pulls it
You supply read-only credentials and we call Oracle Cloud Infrastructure once a day. Nothing to run.
You push it
You send us FOCUS records over the API. Credentials never leave your infrastructure.
Before you begin
- In the OCI console, go to Identity > Users, open the user CostGraph will read as, and add an API key. Download the private key and copy the fingerprint, user OCID and tenancy OCID.
- Put the user in a group and add this policy in the root compartment, so the group can read the cost reports Oracle keeps for your tenancy:
- To see Oracle Cloud savings recommendations in Insights, add one more statement for the same group:
- Note the tenancy’s home region, for example
us-ashburn-1.
Let CostGraph pull
- Open Settings > Integrations and pick Oracle Cloud Infrastructure.
- Name the connection and pick the tenant these charges belong to.
- Enter the values you copied. The form lists what Oracle Cloud Infrastructure needs and marks the optional ones.
- Leave Show Oracle Cloud savings recommendations checked to see Cloud Advisor’s recommendations in Insights, or clear it to turn them off.
- Select Connect.
Credentials are encrypted at rest and used only to read billing data. Revoke the
API key in OCI at any time and the connection stops; nothing else is affected.
Push it yourself
Send the charges to CostGraph as FOCUS records instead. Push FOCUS data covers the connection id, thefocus:write key, and the request shape.
Run the exporter
Rather than build that request yourself, run our exporter. It reads Oracle Cloud Infrastructure on a schedule and pushes the records for you, wherever you want to run it: a container, a KubernetesCronJob, or a binary on a machine you already have.
Savings recommendations
With recommendations on, Oracle Cloud Advisor’s cost recommendations appear in Insights next to CostGraph’s. Each one shows two numbers: Oracle’s estimate, and CostGraph’s price calculated from your bill.- Idle compute instances and unattached block and boot volumes show a saving: what the resource cost on your bill over the last month.
- Resize and other changes (downsizing compute, load balancers or Autonomous Databases, moving to burstable shapes, object lifecycle rules) show the monthly spend they affect, not a saving. They don’t add to the savings total.
- A recommendation for a resource that does not appear on your bill does not show.