Environments allow you to group services and hosts together, making it easy to separate logical phases on your development and deployment pipeline. When you create an account in Kamino we will automatically create three environments for you: Production, Staging and Development.
Each environment has it's own, unique API key. When enabling instrumentation for a host or service make sure you pick the right API key for your target environment.
Finding your API Key
All API keys are listed on the organization settings section. To get there, open the top-right menu and click on the Settings option. If you belong to several organizations make sure you select the organization you are interested in first.
Once in Settings, the very first thing you will see on the page is the list of API Keys. Copy the one for your target environment you are good to go.
Throughout the UI you will always see service and host names paired with the environment they belong to. Also, in some pages like the Services Dashboard and Hosts Dashboard there is a environments filter you can use to look at data from the selected environments only.
Environments and Billing
Besides helping you organize services and hosts, the use of environments also has an effect on billing. Each environment can be either:
- Production: Gets full retention (usually 14 days) on all metrics and tracing data, and all data you send with Production API Keys is metered and in accordance to your subscription details.
- Non-Production: Gets 24 hours of data retention and can only be used for non-production purposes like testing, development, staging and pre-production environments, absolutely free of charge.
Make sure that you select the right API keys for non-production environments to avoid undesired charges.
Note: In the near future we will allow you to create and modify as many environments as you wish. If you need to create or modify any environment before that, let us know and we will do it for you.