Stardog

Agent Check

Supported OS:

Overview

Get metrics from the 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:

Install the developer toolkit on any machine.
Run ddev release build stardog to build the package.
Download the Datadog Agent.
Upload the build artifact to any host with an Agent and run datadog-agent integration install -w path/to/stardog/dist/<ARTIFACT_NAME>.whl.

Configuration

To configure the Stardog check:

Create a stardog.d/ folder in the conf.d/ folder at the root of your Agent’s directory.
Create a conf.yaml file in the stardog.d/ folder previously created.
Consult the sample stardog.yaml file and copy its content in the conf.yaml file.
Edit the conf.yaml file to point to your server and port, set the masters to monitor.
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!