Class DependencyMonitor

constructor

• new DependencyMonitor(options?: DependencyMonitorOptions): DependencyMonitor

  Creates an instance of DependencyMonitor.

  Parameters

  • Optionaloptions: DependencyMonitorOptions = {}

    Optional configuration options for the monitor.

  Returns DependencyMonitor

  Default

  { cacheDurationMs: 60000, refreshThresholdMs: 5000, checkIntervalMs: 15000 }
  Copy

  Example

  const monitor = new DependencyMonitor({
    cacheDurationMs: 60000, // Cache duration of 1 minute
    refreshThresholdMs: 5000, // Refresh threshold of 5 seconds
    checkIntervalMs: 15000, // Check interval of 15 seconds
  });
  Copy

checkIntervalStarted

const monitor = new DependencyMonitor();
console.log(monitor.checkIntervalStarted); // false
monitor.startDependencyCheckInterval();
console.log(monitor.checkIntervalStarted); // true
Copy

getAllStatuses

• getAllStatuses(): Promise<DependencyStatus[]>

  Retrieves the statuses of all registered dependencies.

  Returns Promise<DependencyStatus[]>

  • A promise that resolves to an array of dependency statuses.

  Example

  const statuses = await monitor.getAllStatuses();
  console.log(statuses);
  // Output:
  // [
  //   { name: 'Database', healthy: true, code: 0, status: 'OK', ... },
  //   { name: 'API', healthy: false, code: 1, status: 'ERROR', ... },
  // ]
  Copy

getPrometheusMetrics

• getPrometheusMetrics(): Promise<string>

  Retrieves the Prometheus metrics for all dependencies.

  Returns Promise<string>

  • A promise that resolves to a string containing the Prometheus metrics.

  Example

  const prometheusMetrics = await monitor.getPrometheusMetrics();
  console.log(prometheusMetrics);
  // Output:
  // # HELP dependency_health The status of the database connection (0 = Healthy, 1 = Unhealthy)
  // # TYPE dependency_health gauge
  // dependency_health{dependency="Database", impact="Database info will not be available."} 0
  // # HELP dependency_latency The latency of the database connection check
  // # TYPE dependency_latency gauge
  // dependency_latency{dependency="Database"} 50
  Copy

getStatus

• getStatus(dependencyName: string): Promise<DependencyStatus>

  Retrieves the status of a specific dependency by name.

  Parameters

  • dependencyName: string

    The name of the dependency to check.

  Returns Promise<DependencyStatus>

  • A promise that resolves to the status of the specified dependency.

  Example

  const status = await monitor.getStatus('Database');
  console.log(status);
  // Output:
  // { name: 'Database', healthy: true, code: 0, status: 'OK', ... }
  Copy

register

• register(dependency: DependencyCheckOptions): void

  Registers a new dependency to be monitored.

  Parameters

  • dependency: DependencyCheckOptions

    The dependency to register.

  Returns void

  Example

  monitor.register({
    name: 'Database',
    description: 'Database connection check',
    impact: 'Database data will be unavailable.',
    check: async () => {
      // Perform some check (e.g., ping a database)
      return SUCCESS_STATUS_CODE;
    },
  });
  Copy

startDependencyCheckInterval

• startDependencyCheckInterval(): void

  Starts the interval for checking dependencies.

  Returns void

  Example

  monitor.startDependencyCheckInterval();
  Copy

stopDependencyCheckInterval

• stopDependencyCheckInterval(): void

  Stops the interval for checking dependencies.

  Returns void

  Example

  monitor.startDependencyCheckInterval();
  Copy