B.7. User-Defined Tasks

Documentation

VoltDB Home » Documentation » Administrator's Guide

B.7. User-Defined Tasks

The following tables describe the metrics for measuring and monitoring user-defined tasks.

Table B.14. Tasks

MetricsTypeDescription
voltdb_​scheduler_​action_​status_​infoMetadata

Informational metric with scheduler metadata. Tags:

  • PARTITION_ID - The numeric ID for the logical partition running the task procedure. Directed procedures run on each logical partition. Multi-partition procedures run on the multi-partition initiator.

  • TASK_NAME - The name of the task.

  • TASK_STATUS - The current status of the task. Possible values include: RUNNING - The task is enabled and running normally; DISABLED - The task is disabled and not running. ERROR - The task returned an error and was stopped due to the ON ERROR STOP attribute. PAUSED - The database is paused or is running on a DR replica, so the task is not currently running but will restart when the database resumes or is promoted.

  • TASK_ORIGIN - "System" or "User".

  • TASK_SCOPE - The execution scope of the task, which matches the RUN ON attribute. Possible values are "Database", "Hosts", or "Partitions".

voltdb_​scheduler_​procedure_​execution_​time_​secondsHistogram

The distribution of time the task took to execute.

voltdb_​scheduler_​procedure_​failure_​totalCounter

The number of times the procedure generated an error when run.Tags:

  • same as above.

voltdb_​scheduler_​procedure_​invocation_​totalCounter

The total number of invocations of the task's procedure.

voltdb_​scheduler_​procedure_​wait_​time_​secondsHistogram

The distribution of time between when the procedure was scheduled to run and when it was invoked.

voltdb_​scheduler_​task_​execution_​time_​secondsHistogram

The distribution of the amount of time taken to schedule an instance of the task.

voltdb_​scheduler_​task_​invocation_​totalCounter

The total number of invocations of the task's schedule.

voltdb_​scheduler_​task_​wait_​time_​secondsHistogram

The distribution of the difference between when the task was scheduled to run and when the scheduler was invoked.

voltdb_​task_​priority_​queue_​depth_​totalGauge

The number of tasks in the queue.

voltdb_​task_​priority_​queue_​poll_​count_​totalCounter

The number of tasks that left the queue.

voltdb_​task_​priority_​queue_​wait_​time_​secondsHistogram

The distribution of the length of time tasks were waiting in the queue.

voltdb_​task_​queue_​depth_​totalGauge

The number of tasks in the queue.

voltdb_​task_​queue_​poll_​count_​totalCounter

The number of tasks that left the queue (and started executing) in the past five seconds.

voltdb_​task_​queue_​wait_​time_​secondsHistogram

The distribution of time tasks were waiting in the queue.