Custom Metrics & Unit Economics
Inject external business or technical metrics into Pelanor—whether you need unit-economics KPIs (e.g., cost per API call) or simply want to display custom metrics alongside cloud costs.
Overview
Custom metrics add context to your cloud spend. They power two primary use-cases:
- Unit Economics – combine cost with a business KPI (users, API calls, GB processed) to track efficiency trends.
- Enhanced Reporting – surface any metric as a column, filter, or chart in standard Pelanor reports and dashboards.
Metric Types
| Type | Description | Example | Best For |
|---|---|---|---|
| Basic Metrics | A single count value per timestamp. | Total daily active users | Org-level KPIs (users, requests) |
| Dimensional Metrics | Metric values split by one or more properties. | Active users per region per day | Deeper analysis across segments |
Getting Started
Integration Options
API Integration (recommended)
Open Custom Metrics
Navigate to Unit Cost → Custom Metrics in Pelanor.
Review the API Guide
Click API Documentation to view payload schemas and examples.
Send Your Data
POST metrics to the /v1/custom-metrics endpoint using the documented format.
- Pelanor can ingest periodic CSVs dropped into a dedicated S3 bucket or uploaded manually.
- Contact Support to configure ingestion.
- Pelanor can ingest periodic CSVs dropped into a dedicated S3 bucket or uploaded manually.
- Contact Support to configure ingestion.
Pelanor can pull metrics from common observability back-ends:
- Datadog
- Amazon CloudWatch
- Snowflake
Reach out to enable automatic collection.
After upload, processing may take a few minutes before metrics become searchable.
Accessing Your Metrics
Imported metrics appear in two places:
- Reports & Dashboards – add a metric as a column, filter, or chart just like built-in cost metrics.
- Unit Cost Dashboard – a purpose-built view that pairs cost with a denominator metric to compute unit costs.
Unit Cost Dashboard
Cost Filters
Refine which costs participate in unit-cost calculations—for example, include only production spend or tag-based subsets.
Using the Dashboard
Configure Cost Filters
Select which resources should count toward your calculations.
Set Date Range
Choose the analysis window (daily, weekly, monthly).
Choose Aggregation
Pick how to roll up data—daily, weekly, or monthly.
- Current vs. previous period summaries
- Unit-cost trends
- Cost-distribution charts
- Detailed tables
- Current vs. previous period summaries
- Unit-cost trends
- Cost-distribution charts
- Detailed tables
Includes everything from Basic Metrics, plus segment breakdowns (e.g., by region).
Working with Widgets
Add Widget to Dashboard
In any widget menu, click Add to dashboard.
Select Destination
Choose which dashboard should host the widget.
View the Widget
The widget is appended to the destination dashboard automatically.