Managing device services

Related topics

The alarms API for REST API methods concerning alarms.
Device management & connectivity > Device integration > Fragment library > Alarms for details on how to raise and clear alarms.
The events API for REST API methods concerning events.
The measurements API for REST API methods concerning measurements.
Device management & connectivity > Device integration > Fragment library > Measurements for details on measurements.

The Device Management application lets you monitor the data that your devices send about the services they are running.

The Services tab on the device details view provides an overview of the services running on a given device and acts as an entry point to the service details view. There you can see detailed information about measurements, events and alarms sent for every service.

For services that support commands, actions like Start, Stop, Restart, or custom commands appear in the menu of each service. This allows users to quickly send commands without opening the full service details.

Services list

The following tabs make up the service details view, each described in detail in a separate sector:

Tab	Description
Alarms	Provides information on the alarms for a service. See Working with alarms. Available for each service.
Events	Displays events related to a service. Available for each service.
Measurements	Provides a default visualization of numeric data of the service in the form of charts.
Commands	Allows users to send command actions to a service and view the history of executed commands.

Service details

Service commands

The Commands tab allows users to send available service commands and track their execution history. If a service supports commands, they will appear as action buttons in the services list and as selectable options in the service Commands tab.

Sending commands to services

For a service to support commands, it must include the c8y_ServiceCommand fragment in its supported operations.

Supported services may provide specific command actions, such as:

Start/stop
Restart
Custom commands (for example, “Flush cache”, “Update”, “Reset settings”)

If a service does not specify commands, a default set (Start, Stop, Restart) is available.

Tracking service command history

The Commands tab displays a history of executed commands, including:

The command type (Start, Stop, and so on).
The execution status (Pending, Completed, Failed).
Timestamps for sent and completed actions.

Alarms

The Alarms tab provides information on the alarms of a service. See Working with alarms for detailed information on alarms.

Info

The service details Alarms tab displays only alarms which have the particular service as a source. It does not display any alarms sourced by the device itself.

Events

The Events tab displays events related to a service. See Troubleshooting devices for detailed information.

Info

The service details Events tab displays only events which have the particular service as a source. It does not display any events sourced by the device itself.

Measurements

The Measurements tab provides a default visualization of numeric data for the service in the form of charts.

Info

The service details Measurements tab displays only measurements which have the particular service as a source. It does not display any measurements sourced by the device itself.

For more information about how to use the Measurements tab see Measurements.