The Service Map for APM is here!
home Home docs Docs api API

Stardog

Agent Check Agent Check

Supported OS: Linux Mac OS Windows

Overview

Get metrics from Stardog service in real time to:

  • Visualize and monitor Stardog states
  • Be notified about Stardog failovers and events.

Setup

The Stardog check is NOT included in the Datadog Agent package.

Installation

To install the Stardog check on your host:

  1. Download the Datadog Agent.
  2. Download the check.py file for Stardog.
  3. Place it in the Agent’s checks.d directory.
  4. Rename it to stardog.py.

Configuration

To configure the Stardog check:

  1. Create a stardog.d/ folder in the conf.d/ folder at the root of your Agent’s directory.
  2. Create a conf.yaml file in the stardog.d/ folder previously created.
  3. Consult the sample stardog.yaml file and copy its content in the conf.yaml file.
  4. Edit the conf.yaml file to point to your server and port, set the masters to monitor.
  5. Restart the Agent.

Validation

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

Data Collected

Metrics

stardog.dbms.mem.mapped.max
(gauge)		 The maximum amount of memory used for memory mapping
shown as byte
stardog.dbms.mem.mapped.used
(gauge)		 The number of bytes used in the memory map
shown as byte
stardog.dbms.memory.direct.reserve
(gauge)		 The amount of direct memory reserved
shown as byte
stardog.system.cpu.usage
(gauge)		 CPU usage
shown as byte
stardog.system.uptime
(gauge)		 The number of seconds that Stardog has been running
shown as second
stardog.dbms.memory.heap.reserve
(gauge)		 The heap memory reserved
shown as byte
stardog.dbms.memory.managed.direct
(gauge)		 Managed direct memory
shown as byte
stardog.dbms.memory.managed.heap
(gauge)		 Managed heap memory
shown as byte
stardog.dbms.mem.heap.used
(gauge)		 The amount of heap memory used
shown as byte
stardog.dbms.mem.heap.max
(gauge)		 The maximum heap size
shown as byte
stardog.dbms.mem.direct.buffer.used
(gauge)		 The amount of direct memory used
shown as byte
stardog.dbms.mem.direct.buffer.max
(gauge)		 The maximum amount of direct memory that can be used
shown as byte
stardog.dbms.mem.direct.pool.max
(gauge)		 The maximum size of the direct memory pool
shown as byte
stardog.dbms.mem.direct.pool.used
(gauge)		 The amount of memory used from the direct pool
shown as byte
stardog.dbms.mem.direct.max
(gauge)		 The maximum amount of direct memory that can be used
shown as byte
stardog.dbms.mem.direct.used
(gauge)		 The amount of direct memory used
shown as byte
stardog.databases.system.planCache.ratio
(gauge)		 Plan cache ration
shown as percent
stardog.databases.system.planCache.size
(gauge)		 Plan cache size
shown as byte
stardog.databases.txns.openTransactions
(gauge)		 The number of open transations on a given database
shown as unit
stardog.databases.queries.running
(gauge)		 The number of currently running queries on a given database
shown as unit
stardog.databases.openConnections
(gauge)		 The number of open connections on a given database
shown as unit
stardog.databases.txns.speed.count
(gauge)		 The current transaction speed on the database
shown as unit
stardog.databases.txns.speed.max
(gauge)		 The fastest transaction speed achieved
shown as unit
stardog.databases.txns.speed.mean
(gauge)		 The average transaction speed on the database
shown as unit
stardog.databases.txns.speed.min
(gauge)		 The slowest transaction speed on the database
shown as unit
stardog.databases.txns.speed.p50
(gauge)		 The 50th percentile transaction speed on the database
shown as unit
stardog.databases.txns.speed.p75
(gauge)		 The 75th percentile transaction speed on the database
shown as unit
stardog.databases.txns.speed.p95
(gauge)		 The 95th percentile transaction speed on the database
shown as unit
stardog.databases.txns.speed.p98
(gauge)		 The 98th percentile transaction speed on the database
shown as unit
stardog.databases.txns.speed.p99
(gauge)		 The 99th percentile transaction speed on the database
shown as unit
stardog.databases.txns.speed.p999
(gauge)		 The 99.9th percentile transaction speed on the database
shown as unit
stardog.databases.txns.speed.stddev
(gauge)		 The stardard deviation for the transaction speed
shown as unit
stardog.databases.txns.speed.m15_rate
(gauge)
shown as unit
stardog.databases.txns.speed.m1_rate
(gauge)
shown as unit
stardog.databases.txns.speed.m5_rate
(gauge)
shown as unit
stardog.databases.txns.speed.mean_rate
(gauge)
shown as unit
stardog.databases.queries.speed.count
(gauge)		 The current query speed on the database
shown as unit
stardog.databases.queries.speed.max
(gauge)		 The fastest query speed achieved
shown as unit
stardog.databases.queries.speed.mean
(gauge)		 The average query speed on the database
shown as unit
stardog.databases.queries.speed.min
(gauge)		 The slowest query speed on the database
shown as unit
stardog.databases.queries.speed.p50
(gauge)		 The 50th percentile query speed on the database
shown as unit
stardog.databases.queries.speed.p75
(gauge)		 The 75th percentile query speed on the database
shown as unit
stardog.databases.queries.speed.p95
(gauge)		 The 95th percentile query speed on the database
shown as unit
stardog.databases.queries.speed.p98
(gauge)		 The 98th percentile query speed on the database
shown as unit
stardog.databases.queries.speed.p99
(gauge)		 The 99th percentile query speed on the database
shown as unit
stardog.databases.queries.speed.p999
(gauge)		 The 99.9th percentile query speed on the database
shown as unit
stardog.databases.queries.speed.stddev
(gauge)		 The stardard deviation for the query speed
shown as unit
stardog.databases.queries.speed.m15_rate
(gauge)
shown as unit
stardog.databases.queries.speed.m1_rate
(gauge)
shown as unit
stardog.databases.queries.speed.m5_rate
(gauge)
shown as unit
stardog.databases.queries.speed.mean_rate
(gauge)
shown as unit

Events

The Stardog check does not include any events.

Service Checks

The Stardog check does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.

Mistake in the docs? Feel free to contribute!

Table of Contents