@telegraph-notify/telegraph-dashboard v1.0.0

Telegraph Dashboard

The dashboard is a centralized location for visualizing your Telegraph service implementation and an observability tool for monitoring system health.

Features

• View notification status and filter notification requests by recipient ID or channel.
• View users and filter by User ID, Email, or notification preferences.
• Visualize system activity and performance with charts displaying:
  • Successful and failed notification deliveries.
  • Notification deliveries by channel.
  • Notification failures by channel.
• Inspect messages which failed processing and were diverted to the service's dead letter queue.

Installation

To install the dashboard, run the following command:

$ npx @telegraph-notify/telegraph-dashboard

This will create a subdirectory named telegraph-dashboard. Navigate to this directoy and run:

$ npm install

To initialize the dashboard server, a .env file must be created with the following information:

Please refer to Telegraph CLI for more information.

Usage

Running the Dashboard

The dashboard is intended to be run on localhost by a trusted entity. Run the following command to start the dashboard:

$ npm run prod

The server listens for connections on port 5173 and can be viewed from a browser at localhost:5173/.

Interpreting Notification Logs

Notification logs are generated so developers can extract metrics from Telegraph if desired and as an observability tool. When a notification failure occurs, the dashboard attaches a failure badge to the log. The following table maps logs to their lambda's so users can understand where in the system to start debugging.