Linkerd is an open source service mesh designed to be deployed into a variety of container schedulers and frameworks such as kubernetes.

Prerequisite

  1. Edit the file agent/packaging/kubernetes/opsramp/agent/conf/app/metrics/linkerd/auto-monitoring.yaml
  2. Set prometheus_metrics_port to linkerd prometheus endpoint port (on which it is exposing metrics)

Configuring the credentials

Configure the credentials in the directory /opt/opsramp/agent/conf/app.d/creds.yaml

linkerd:
- name: linkerd
  user: <username>
  pwd: <Password>
  encoding-type: plain
  labels:
    key1: val1
    key2: val2
  

Configuring the application

Kubernetes environment

Configure the application in config.yaml

- name: linkerd
  container-checks:
    image-check:
      - controller
    port-check:
      - 8085
  

Validate

Go to Resources under the Infrastructure tab to check if your resources are onboarded and the metrics are collected.

Supported metrics

OpsRamp MetricMetric Display NameUnit
linkerd_request_total

Total count of HTTP requests.
Request Totalrequests/second
linkerd_response_latency

Avg Elapsed times between request headers being received and its response stream completing since last pool.
Response Latencymilliseconds
linkerd_response_total

Total count of HTTP responses.
Response Totalresponses/second
linkerd_retry_skipped_total

Total count of retryable HTTP responses that were not retried.
Retry Skipped Totalresponses/second
linkerd_route_request_total

Total count of route HTTP requests.
Route Request Totalrequests/second
linkerd_route_response_latency

Avg Elapsed times between a route request headers being received and its response stream completing since last pool.
Route Response Latencymilliseconds
linkerd_route_response_total

Total count of route HTTP responses.
Route Response Totalresponses/second
linkerd_route_retry_skipped_total

Total count of retryable route HTTP responses that were not retried.
Route Retry Skipped Totalresponses/second
linkerd_route_actual_request_total

Total count of actual route HTTP requests.
Route Actual Request Totalrequests/second
linkerd_route_actual_response_latency

Avg Elapsed times between a actual route request headers being received and its response stream completing since last pool.
Route Actual Response Latencymilliseconds
linkerd_route_actual_response_total

Total count of actual route HTTP responses.
Route Actual Response Totalresponses/second
linkerd_route_actual_retry_skipped_total

Total count of retryable actual route HTTP responses that were not retried.
Route Actual Retry Skipped Totalresponses/second
linkerd_tcp_open_total

Total count of opened connections.
Tcp Open Totalconnections/second
linkerd_tcp_open_connections

Number of currently-open connections.
Tcp Open ConnectionsConnections
linkerd_tcp_read_bytes_total

Total count of bytes read from peers.
Tcp Read Bytes Totalbytes/second
linkerd_tcp_write_bytes_total

Total count of bytes written to peers.
Tcp Write Bytes Totalbytes/second
linkerd_tcp_close_total

Total count of closed connections.
Tcp Close Totalconnections/second
linkerd_tcp_connection_duration

Avg Connection lifetimes since last pool.
Tcp Connection Durationmilliseconds
linkerd_control_request_total

Total count of control HTTP requests.
Control Request Totalrequests/second
linkerd_control_response_latency

Avg Elapsed times between a control request headers being received and its response stream completing since last pool.
Control Response Latencymilliseconds
linkerd_control_response_total

Total count of control HTTP responses.
Control Response Totalresponses/second
linkerd_control_retry_skipped_total

Total count of retryable control HTTP responses that were not retried.
Control Retry Skipped Totalresponses/second
linkerd_process_start_time

Time that the process started (in seconds since the UNIX epoch).
Process Start Timeseconds
linkerd_process_cpu_seconds_total

Total user and system CPU time spent in seconds.
Process Cpu Seconds Totalseconds
linkerd_process_open_fds

Number of open file descriptors.
Process Open FdsFiles
linkerd_process_max_fds

Maximum number of open file descriptors.
Process Max FdsFiles
linkerd_process_virtual_memory

Virtual memory size in bytes.
Process Virtual Memorybytes
linkerd_process_resident_memory

Resident memory size in bytes.
Process Resident Memoryytes