Documentation

    KPI Builder

    A KPI combines measures into a single metric - most often a cost measure divided by a usage or business measure, such as Amortized Cost ÷ Requests. You build KPIs on the KPI Builder tab of Unit Economics.

    📘

    Before you start

    Your usage or business measures need to be flowing in first. See Onboard a Telemetry Pipeline.

    The KPI Builder lists existing KPIs with their providers, source pipeline, output format, and formula. Use the All / Customer KPIs / Umbrella KPIs filter to switch between your KPIs and Umbrella's out-of-the-box set.



    Create a KPI

    1. On the KPI Builder tab, click + Add New KPI.

    2. Enter a KPI Name, choose or create a Category, and set the Output Format (e.g. Cost, count, bytes).

    3. In the Formula Builder, search for and add measures from the metric library on the left - grouped into Cloud Cost, Cloud Usage, and Pipeline Measures.

    4. Combine measures using the math symbols: +, −, ×, ÷, ( ), and %.

    5. Optionally set a Formula Aggregation - SUM, AVG, MIN, MAX, or COUNT.

    6. Under Group by, choose the dimensions to include (for example, Date, Payer Account, Service).

    7. Check the KPI Preview, then click Save KPI.

      KPI Builder formula and group-by

    Measures you can use

    • Cost - AWS: Amortized, Net Amortized, Unblended, Net Unblended, Public Cost, Distributed · Azure: Amortized, Unblended, Public Cost · GCP: Cost
    • Usage - Hours, Requests, Bytes, Resource Quantity, Other
    • Telemetry (ingested) - your business measures (revenue, users, transactions) and usage measures (CPU, memory, network)
    👍

    Tip - express a KPI as a percentage

    Multiply the result by 100, and set a free-text unit such as %, $, GB, hrs, or users.

    📘

    Examples

    Lambda cost per 1M invocations = Unblended Cost ÷ Requests × 1,000,000
    EC2 on-demand vs. reserved savings = Public Cost − Amortized Cost

    Edits to an ad-hoc KPI apply to historical data as well.


    MSP KPIs




    👍

    Next step

    Analyze your KPI in CUE & Assets, or use it to allocate shared cost.

    📸 Screenshots: unit-economics-kpi-list.png → Image 3 or 5; unit-economics-kpi-form.png → Image 8
    ❓ Confirm: full list of Output Format options; whether the "edits apply to historical data" behavior differs for non-ad-hoc KPIs.