README FIRST!

Here is a quick guide on how to connect a custom data source to Eyer. Data can come from an open source agent, custom code, scripts or instrumented existing code.

• If you plan to use an open source agent, please read section 1 below, as you will need a mapping from the agent format to the internal Eyer format.

• If you plan to instrument existing code, or have control of the output format, you can read section 2.

Section 1

1. Get your metrics with names & timestamps in a “flat” JSON format. The less nesting, the easier the mapping will be.

   1. You can for instance have the metrics and names in a separate “fields” section, and meta-data in a “tags” section (see example below). The “fields” section can repeat x times, based on how many databases you have.

      { "metrics": [ { "fields": { "disk_reads_mean": 1.0121461361787716, "disk_writes_per_sec_mean": 0.8571885607181682, "last_Run_mean": 1740047577489, "log_bytes_flushed_mean": 3.9596305549082618, "logical_reads_mean": 914.9966524003087, "total_sessions_mean": 14, "waits_total": 0, "waits_total_mean": 7.3 }, "name": "dbwatch", "tags": { "host": "testmachine1", "instance": "DatabaseServer1", }, "timestamp": 1740047760 } ] }

2. Create a mapping from your data to the Eyer format. There are multiple ways of mapping your data, as of now we have two different mapping examples available

   1. Mapping example 1. In this example, each repeating field is creating a new node with corresponding metrics based on a tag field. To better understand the node structure of Eyer, please see this article.

   2. Mapping example 2. In this example, each repeating field is creating a new metrics on the same node, if the tag field is the same (repeating). To better understand the node structure of Eyer, please see this article.

3. Validate your mapping with our API

4. Contact us to enable your custom endpoint.

Section 2

Since you can control the output format, you can choose to format it directly to a generic format and skip the mapping.

1. Refer to the generic format here, and structure your data output accordingly.

2. Contact us to enable your custom endpoint.