This repository holds all the entity types that exist in New Relic and their configurations.
By proposing changes to this repository you can achieve the following:
- Create a new entity type
- Generate entities from a new source of data (telemetry, logs, etc)
- Change how an entity is represented in different experiences via golden metrics ( New Relic Lookout, workloads, etc) and summary metrics (entity explorer)
- Modify the summary of an entity type
- Modify the lifecycle of an entity and make them
alertable
All notable changes are defined in the releases page.
For newcomers, we recommend checking the creating an entity type example. This document will walk through creating an entity type from scratch.
If you have experience with the repo and are looking for a specific section documentation:
Whenever there's a contribution via pull request, some validations are automatically executed to verify that the provided definition meets the basic requirements:
- The definition files are not malformed, incorrect or missing mandatory fields.
- The identifier cannot be extracted from an attribute with the same name for two different Domain-Types, unless conditions are set to differentiate them, so that the conditions from one entity are not a superset of the other.
You can execute the validations locally using our dockerized validator:
docker-compose run validate-definitions
Remember that you may need to rebuild the images to pick up validation changes if you have run this in the past.
docker-compose build validate-definitions
Read more about the current validations.
Is the information provided in the repository not enough to solve your doubts? Get in touch with the team by opening an issue!
Other Support Channels
- New Relic Documentation: Comprehensive guidance for using our platform
- New Relic Community: The best place to engage in troubleshooting questions
- New Relic Developer: Resources for building a custom observability applications
- New Relic University: A range of online training for New Relic users of every level
- New Relic Technical Support 24/7/365 ticketed support. Read more about our Technical Support Offerings.
We encourage you to add new entity types! Keep in mind when you submit your pull request, you'll need to sign the CLA via the click-through using CLA-Assistant. You only have to sign the CLA one time per project.
If you have any questions, or to execute our corporate CLA, required if your contribution is on behalf of a company, please drop us an email at [email protected].
A note about vulnerabilities
As noted in our security policy, New Relic is committed to the privacy and security of our customers and their data. We believe that providing coordinated disclosure by security researchers and engaging with the security community are important means to achieve our security goals.
If you believe you have found a security vulnerability in this project or any of New Relic's products or websites, we welcome and greatly appreciate you reporting it to New Relic through HackerOne
Entity Synthesis Definitions is licensed under the Apache 2.0 License.