Silk

Supported OS Linux Mac OS Windows

Integration version2.2.1

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

  1. 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.

  2. 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:

SilkDatadog
INFOinfo
ERRORerror
WARNINGwarning
CRITICALerror

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.

PREVIEWING: alai97/reorganize-some-sections-in-dora-metrics