Repository files navigation

DataDoc is an endpoint monitoring, detection and traffic simulation tool that provides real-time metrics and customizable alert notifications.

• Getting Started
  • Prerequisites
  • Installation
• How To Use
  • Adding Workspaces
  • Using the Monitoring Tool
  • Using the Simulation Tool
  • Configuring Alerts
• Tech Stack
• Authors

• Node.js v18^
• Docker

This tool requires the npm packageexpress-endpoints-monitor to detect and gather metrics for endpoints in your Express application. To understand how to use this plugin, see thefull documentation.

1. Run the following terminal command in your project directory that you would like to begin monitoring:

   npm install express-endpoints-monitor

   This should have created aexpress-endpoints-monitor/ folder in yournode_modules/ directory

2. WIP:Clone this repository. Unzip the file in a separate folder and open a terminal in this directory. Run the following commands:

   npm installnpm run build

   This will install the needed dependences and build the desktop application.

1. Open your Express application file in a text editor. At the top of the file, import the plugin by adding:

   const expMonitor = require("express-endpoints-monitor");

   This module comes with several functions to register endpoints with the monitoring application and begin log requests made to those endpoints.

2. In your file, include the following line:

   app.use(expMonitor.gatherMetrics);

   This will record metrics for incoming requests and make them available to the metrics API which will be set up later.

3. Under an endpoint that you would like to begin monitoring, include theexpMonitor.registerEndpoint middleware. For example, this may look like:

   app.get(...,  expMonitor.registerEndpoint,  ...);

   The order of this function in the middleware chain is not important. This middleware will stage this particular endpoint for exporting, and can be used in multiple endpoints.

4. Once all desired endpoints have been registered, they must be exported on the metrics server. In yourapp.listen declaration, add these lines to the passed-in callback function:

   app.listen(..., function callback() {  ...  expMonitor.exportEndpoints();  startMetricsServer(<METRICS_SERVER_PORT>))

   This will start up a metrics server onMETRICS_SERVER_PORT. If this argument is not specified, it will resolve to9991. The server includes several endpoints, one of which isGET /endpoints which responds with the list of registered endpoints in JSON format.

   Alternatively, if you would like to export all endpoints, you may replace the above snippet with theexportAllEndpoints function:

   app.listen(..., function callback() {  ...  expMonitor.exportAllEndpoints();  startMetricsServer(<METRICS_SERVER_PORT>))

   This will expose all endpoints regardless of whether they include theregisterEndpoint middleware.

5. Your application is ready to start monitoring! To verify your setup, use a browser or API testing tool to interact with the metrics API started athttp://localhost:<METRICS_SERVER_PORT>. The list of available endpoints is:

   • GET /endpoints
   • GET /metrics
   • DELETE /metrics

6. To see the full use of the library, see thenpm page.

In your localDataDoc folder, run the following command:

docker compose up

The-d flag may be supplied to detach the instance from the terminal.

1. In your localDataDoc folder, run the following command if you haven't during the installation steps:

   npm build

   This command only needs to be run once.

2. WIP: In the same folder, run the following command to start the desktop application:

   npm start

• Jo HuangLinkedIn |GitHub
• Jonathan HuangLinkedIn |GitHub
• Jamie SchiffLinkedIn |GitHub
• Mariam ZakariadzeLinkedIn |GitHub