Configuration of business metrics definitions

Add, edit and delete a business metrics definition

The business metrics definitions are configured in the preferences page 1 under the section "Business Driven Cost Analytics" 2.

You can then see your current business metrics definitions, add a new one 1, edit and even duplicate an existing one 2. The rest of this document will describe the common parameters of a business metrics definiton and the ones specific to each provider.

Common parameters of a business metrics provider

A business metric definition has 5 required parameters regardless of the provider:

• 1 a name

• 2 a unit name to be displayed along the values in reports

• 3 a currency symbol also to be displayed in reports

• 4 a factored cost multiplicator. If your business metric volumetry is large, the multiplicator will make the cost factored easier to read. Example: if your factor is 1000, instead of having a cost of 0.00005 per request, a cost of 0.05 per 1000 requests will be used.

• 5 a provider, see the sections below for each provider specific parameters

New Relic

Teevity is using the API v2 of New Relic to collect data.

• 1 the New Relic API v2 key used to access your data

• 2 the url of the API server which includes the id of your New Relic app

• 3 the body of the request to specify the metrics and filters, for example names[]=EndUser&values[]=requests_per_minute&summarize=false

Amazon S3 Flat Files

Your business metrics data can come from a flat file where the metric is saved as a predefined format.

Metric files format and location

• 1 Bucket name, example: appname-metrics

• 2 Bucket prefix, example: teevity-metrics/businessMetrics_impressions-. The filename suffix shoud be YYYY-MM. The file full name businessMetrics_impressions-2017-12

• 3 Bucket S3 Region, example: us-east-1

Metrics file content

The file content must be a series of values separated by a comma (,). The first value in the file is for the first hour of the month. When values are missing, you can just type two consecutive commas. You don't have to provide all the values for the hours of the month if it's not over yet (i.e., if we are mid-month, there will only be approximately 15*24 values in the file). A file example is available here.

Access Control to your AWS environment

Regardless of the method described below, you can optionally declare a role to assume for the access to the S3 bucket, if so you will need to enter the id of the account where the role TeevityPollerRole_BusinessMetrics resides 5.

If you use the method based on an IAM User, you can enter the Access Key and Secret Key of the user 4

Or if you use an "IAM Cross Account External Trust Relationship", you will have to enter the id of the account where the role TeevityCrossAccountTrustRole resides 1. You will need also the External id provided 2

Amazon CloudWatch Metrics

You can use the metrics generated by Amazon CloudWatch like the number of requests of an Elastic Load Balancer, an API Gateway or traffic etc.

• 1 and 2 the credentials to access the Amazon CloudWatch metrics API

• 3 the metric name, for example RequestCount for an AWS ELB 

• 4 the metric namespace, AWS/ApplicationELB in our ELB example

• 5 the metric statistic, Sum for example

Cloud Usage Detailed Data

You can use your own cloud usage data as a proxy or a pulse of the business activity. For example, it can be the network traffic exposed by the egress in your cloud usage data.

1 the UUID of the report with the usage data. Learn more about how to explore and build a report of your usage data. The UUID is found in the URL of the report : https://cloudcost-app.teevity.com/cloudcost/currentChargesPanel/detailedCostAnalyticsDashboard.jsp?reportUUID=8a18dd16-fbd8-11ed-be56-0242ac120002&displayType=normal