Silk

Supported OS Linux Mac OS Windows

Integration version2.2.0

Overview

This check monitors Silk through the Datadog Agent.

Setup

Follow the instructions below to install and configure this check for an Agent running on a host. For containerized environments, see the Autodiscovery Integration Templates for guidance on applying these instructions.

Installation

The Silk check is included in the Datadog Agent package. No additional installation is needed on your server.

Configuration

Edit the silk.d/conf.yaml file, in the conf.d/ folder at the root of your Agent’s configuration directory to start collecting your Silk performance data. See the sample silk.d/conf.yaml for all available configuration options.
Restart the Agent.

Validation

Run the Agent’s status subcommand and look for silk under the Checks section.

Data Collected

Metrics

silk.replication.system.logical_in (gauge)	Replication system logical in
silk.replication.system.logical_out (gauge)	Replication system logical out
silk.replication.system.physical_in (gauge)	Replication system physical in
silk.replication.system.physical_out (gauge)	Replication system physical out
silk.replication.volume.logical_in (gauge)	Replication volume logical in
silk.replication.volume.logical_out (gauge)	Replication volume logical out
silk.replication.volume.physical_in (gauge)	Replication volume physical in
silk.replication.volume.physical_out (gauge)	Replication volume physical out
silk.system.block_size.io_ops.avg (gauge)	Average system IO operations tagged by block size Shown as operation
silk.system.block_size.latency.inner (gauge)	System inner latency tagged by block size Shown as millisecond
silk.system.block_size.latency.outer (gauge)	System outer latency tagged by block size Shown as millisecond
silk.system.block_size.throughput.avg (gauge)	Average system throughput tagged by block size Shown as megabyte
silk.system.capacity.allocated (gauge)	Allocated system capacity Shown as kibibyte
silk.system.capacity.allocated_snapshots_and_views (gauge)	Allocated system capacity for snapshots and views Shown as kibibyte
silk.system.capacity.allocated_volumes (gauge)	Allocated system capacity for volumes Shown as kibibyte
silk.system.capacity.curr_dt_chunk (gauge)	Current DT chunk system capacity Shown as kibibyte
silk.system.capacity.free (gauge)	Free system capacity Shown as kibibyte
silk.system.capacity.logical (gauge)	Logical system capacity Shown as kibibyte
silk.system.capacity.physical (gauge)	Physical system capacity Shown as kibibyte
silk.system.capacity.provisioned (gauge)	Provisioned total system capacity Shown as kibibyte
silk.system.capacity.provisioned_snapshots (gauge)	Provisioned system capacity for snapshots Shown as kibibyte
silk.system.capacity.provisioned_views (gauge)	Provisioned system capacity for views Shown as kibibyte
silk.system.capacity.provisioned_volumes (gauge)	Provisioned system capacity for volumes Shown as kibibyte
silk.system.capacity.reserved (gauge)	Reserved system capacity Shown as kibibyte
silk.system.capacity.total (gauge)	Total system capacity Shown as kibibyte
silk.system.io_ops.avg (gauge)	Average system IO operations Shown as operation
silk.system.io_ops.max (gauge)	Maximum system IO operations Shown as operation
silk.system.latency.inner (gauge)	System inner latency Shown as millisecond
silk.system.latency.outer (gauge)	System outer latency Shown as millisecond
silk.system.read.io_ops.avg (gauge)	Average system read IO operations Shown as operation
silk.system.read.latency.inner (gauge)	System inner read latency Shown as millisecond
silk.system.read.latency.outer (gauge)	System outer read latency Shown as millisecond
silk.system.read.throughput.avg (gauge)	Average system read throughput Shown as megabyte
silk.system.throughput.avg (gauge)	Average system throughput Shown as megabyte
silk.system.throughput.max (gauge)	Maximum system throughput Shown as megabyte
silk.system.views_count (gauge)	Host view count
silk.system.volumes_count (gauge)	Host volume count
silk.system.write.io_ops.avg (gauge)	Average system write IO operations Shown as operation
silk.system.write.latency.inner (gauge)	System inner write latency Shown as millisecond
silk.system.write.latency.outer (gauge)	System outer write latency Shown as millisecond
silk.system.write.throughput.avg (gauge)	Average system write throughput Shown as megabyte
silk.volume.block_size.io_ops.avg (gauge)	Average volume IO operations tagged by block size Shown as operation
silk.volume.block_size.latency.inner (gauge)	Volume inner latency tagged by block size Shown as millisecond
silk.volume.block_size.latency.outer (gauge)	Volume outer latency tagged by block size Shown as millisecond
silk.volume.block_size.throughput.avg (gauge)	Average volume throughput tagged by block size Shown as megabyte
silk.volume.compressed_ratio.avg (gauge)	Average compressed ratio
silk.volume.io_ops.avg (gauge)	Average volume IO operations Shown as operation
silk.volume.io_ops.max (gauge)	Maximum volume IO operations Shown as operation
silk.volume.latency.inner (gauge)	Volume inner latency Shown as millisecond
silk.volume.latency.outer (gauge)	Volume outer latency Shown as millisecond
silk.volume.logical_capacity (gauge)	Volume logical capacity Shown as kibibyte
silk.volume.no_dedup (gauge)
silk.volume.read.io_ops.avg (gauge)	Average volume IO read operations Shown as operation
silk.volume.read.latency.inner (gauge)	Volume inner read latency Shown as millisecond
silk.volume.read.latency.outer (gauge)	Volume outer read latency Shown as millisecond
silk.volume.read.throughput.avg (gauge)	Average volume read throughput Shown as megabyte
silk.volume.size (gauge)	Volume size Shown as byte
silk.volume.snapshots_logical_capacity (gauge)	Volume capacity for snapshots Shown as kibibyte
silk.volume.stream_average_compressed_bytes (gauge)	Average stream compressed size Shown as kibibyte
silk.volume.throughput.avg (gauge)	Average volume throughput Shown as megabyte
silk.volume.throughput.max (gauge)	Maximum volume throughput Shown as megabyte
silk.volume.write.io_ops.avg (gauge)	Average volume IO write operations Shown as operation
silk.volume.write.latency.inner (gauge)	Volume inner write latency Shown as millisecond
silk.volume.write.latency.outer (gauge)	Volume outer write latency Shown as millisecond
silk.volume.write.throughput.avg (gauge)	Average volume write throughput Shown as megabyte

Events

The Silk integration records events emitted by the Silk server. The event levels are mapped as the following:

Silk	Datadog
`INFO`	`info`
`ERROR`	`error`
`WARNING`	`warning`
`CRITICAL`	`error`

Service Checks

silk.system.state
Returns CRITICAL if the system is degraded, WARNING if the system is offline. Returns OK if ONLINE, UNKNOWN if the endpoint is is inaccessible.
Statuses: ok, critical, unknown, warning

silk.server.state
Returns OK if the server is ONLINE, UNKNOWN if the endpoint is inaccessible or returns a non-OK status. Tagged by server_name.
Statuses: ok, unknown

silk.can_connect
Returns CRITICAL if check cannot access stats endpoints, WARNING if an error response is encountered. Returns OK otherwise.
Statuses: ok, critical, warning

Troubleshooting

Need help? Contact Datadog support.