Component library settings

Component library settings are about your own or 3rd part libraries used in monitored application.

In agent or SDK, no matter library name collected as ID or String(literally, e.g. SpringMVC), collector formats data in ID for better performance and less storage requirements.

Also, collector conjectures the remote service based on the component library, such as: the component library is MySQL Driver library, then the remote service should be MySQL Server.

For those two reasons, collector require two parts of settings in this file:

  1. Component Library id, name and languages.
  2. Remote server mapping, based on local library.

All component names and IDs must be defined in this file.

Component Library id

Define all component libraries' names and IDs, used in monitored application. This is a both-way mapping, agent or SDK could use the value(ID) to represent the component name in uplink data.

  • Name: the component name used in agent and UI
  • id: Unique ID. All IDs are reserved, once it is released.
  • languages: Program languages may use this component. Multi languages should be separated by ,

ID rules

  • Java and multi languages shared: (0, 3000]
  • .NET Platform reserved: (3000, 4000]
  • Node.js Platform reserved: (4000, 5000]
  • Go reserved: (5000, 6000]
  • PHP reserved: (6000, 7000]

Example

Tomcat:
  id: 1
  languages: Java
HttpClient:
  id: 2
  languages: Java,C#,Node.js
Dubbo:
  id: 3
  languages: Java
H2:
  id: 4
  languages: Java

Remote server mapping

Remote server will be conjectured by the local component. The mappings are based on Component library names.

  • Key: client component library name
  • Value: server component name
Component-Server-Mappings:
  Jedis: Redis
  StackExchange.Redis: Redis
  SqlClient: SqlServer
  Npgsql: PostgreSQL
  MySqlConnector: Mysql
  EntityFrameworkCore.InMemory: InMemoryDatabase