Skip to main content
Railway runs services, databases, volumes, and VM workloads, and meters vCPU, memory, volume storage, and egress. CostGraph reads Railway usage as FOCUS 1.2 records at a grain of one record per project and service per day. Spend is estimated from Railway’s published prices and can differ from your invoice.

​
Choose how the data reaches us

CostGraph pulls it

You supply read-only credentials and we call Railway 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 Railway, go to Account Settings > Tokens and create an account or workspace token. A project token is scoped to one environment and cannot read workspace usage.
  • Note the id of the workspace to export.
  • The connect form links to the page where you create this credential.

​
Let CostGraph pull

  1. Open Settings > Integrations and pick Railway.
  2. Name the connection and pick the tenant these charges belong to.
  3. Enter the values you copied. The form lists what Railway needs and marks the optional ones.
  4. Select Connect.
CostGraph verifies the credentials with a short fetch before saving, so a wrong value or a missing permission fails while you are still on the form.
Credentials are encrypted at rest and used only to read billing data. Revoke them in Railway 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, the focus:write key, and the request shape.

​
Run the exporter

Your Railway credential stays where you put it, and only the finished FOCUS records reach CostGraph. Run the exporter covers the three ways to run it and the variables it reads.

​
What CostGraph does with it

Records land as raw billing rows, are normalised into line items, and roll up into daily cost. From there Railway spend appears in Cost Overview and in anomaly detection alongside every other provider.

​
Managed sandboxes

The same Railway account can run CostGraph code changes. See Managed sandboxes.