Categorygithub.com/containerssh/metricsintegration
modulepackage
1.0.0
Repository: https://github.com/containerssh/metricsintegration.git
Documentation: pkg.go.dev

# README

ContainerSSH - Launch Containers on Demand

ContainerSSH Metrics Integration Library

Go Report Card LGTM Alerts

This library integrates the metrics service with the sshserver library.

⚠⚠⚠ Warning: This is a developer documentation. ⚠⚠⚠
The user documentation for ContainerSSH is located at containerssh.io.

Using this library

This library is intended as an overlay/proxy for a handler for the sshserver library "handler". It can be injected transparently to collect the following metrics:

  • containerssh_ssh_connections
  • containerssh_ssh_handshake_successful
  • containerssh_ssh_handshake_failed
  • containerssh_ssh_current_connections
  • containerssh_auth_server_failures
  • containerssh_auth_failures
  • containerssh_auth_success

The handler can be instantiated with the following method:

handler, err := metricsintegration.New(
    config,
    metricsCollector,
    backend,
)
  • config is a configuration structure from the metrics library. This is used to bypass the metrics integration backend if metrics are disabled.
  • metricsCollector is the metrics collector from the metrics library.
  • backend is an SSH server backend from the sserver library.

# Functions

No description provided by the author

# Constants

MetricHelpConnections is the help text for the number of connections since start.
MetricHelpCurrentConnections is th ehelp text for the number of currently open SSH connections.
MetricHelpFailedHandshake is the help text for the number of failed SSH handshakes since start.
MetricHelpSuccessfulHandshake is the help text for the number of successful SSH handshakes since start.
MetricNameConnections is the number of connections since start.
MetricNameCurrentConnections is the number of currently open SSH connections.
MetricNameFailedHandshake is the number of failed SSH handshakes since start.
MetricNameSuccessfulHandshake is the number of successful SSH handshakes since start.