Services

Using the Services menu

The Services page provides a full-featured interface to the native DC/OS™ Marathon instance. It provides a comprehensive view of all of the services that you are running. You can filter services by health, status, or service name.

Services

Figure 1 - Services page

Filtering your display

By default, all of your services are displayed, sorted by service name. You can also sort the services by health status, version, region, instances, CPU, memory, disk space or GPU usage.

Name Description
Name The DC/OS service name of the service
Status The status of the service. See details in the following table.
Version The version of the service
Region The region of the service
Instances The number of instances of the service
CPU The number of CPUs in use
Mem The amount of memory in use
Disk The amount of disk space in use
GPU The amount of GPU in use

To set up a filter for your display, click on the down arrow in the search box.

Sort menu

Figure 2 - Sort menu

Service Status

Status Description
Running The Service is reported as running and no instances are reported as deploying or recovering.
Deploying When you request a change to the Service, DC/OS is performing the required actions, which have not completed yet. If a Service is having difficulty getting to a Running state, a warning icon is displayed. This indicates that the Service is waiting for the resource offers it requires to run, or that too many tasks have failed in a short amount of time. More information can be obtained from the Debug tab.
Recovering When a change to the Service has been requested by DC/OS, the instance is killed and a new instance is started. Similar to Deploying, DC/OS is performing the required actions, which have not completed yet.
Stopped A Service with target instances of 0 and with a running tasks count of 0. This state was previously referred to as “Suspended” in the UI.

SDK Service Status

Scheduler tasks based on the DC/OS SDK, leveraging APache® Mesos® native checks in order to provide more detailed information about their status than the above Service Status. These status levels are specific to SDK-based schedulers and their lifecycle.

Status Description
Initializing Scheduler is initializing.
Running All monitored Plans are complete.
Error Creating Service Scheduler encountered an error creating the service.
Deploying (Awaiting Resources) One or more monitored plans are deploying (awaiting resources).
Deploying One or more monitored plans are deploying.
Deploying (Awaiting User Input) One or more monitored plans are awaiting user input.
Degraded (Awaiting Resources) One or more monitored plans are degraded (awaiting resources).
Degraded (Recovering) One or more monitored plans are degraded (recovering).
Backing up One or more monitored backup plans is in-progress.
Restoring One or more monitored restore plans is in-progress.
Service Unavailable Scheduler encountered an error with one or more monitored plans.

Tabs

Click the service name to open the Services Instance page. The Services Instance page organizes information about services under five tabs. Each tab lists information about the configuration and performance of the service.

Instances

Figure 3 - Services instances

Tab Description
Tasks For each task, there is information about its zone, region, status, health and when it was last updated. Click a task to see its complete configuration, working directory and logs.
Configuration Service and Networking configuration variables.
Debug Displays task statistics to help you troubleshoot issues with your cluster.
Endpoints Service configuration variables such as container images, container runtime, and advanced networking settings.
Plans Displays all of a service’s Deployment Plans so that you can track the status of a currently running or finished service. A drop-down menu lets you switch between plans. This tab may not appear in all Service instances, depending on the Service configuration.

For services with a UI, hover over the service name and click open service to view it. You can access the Mesos UI at <hostname>/mesos.

Debugging using the UI

The Services > Debug tab displays the last changes, task failures, and other status messages, which can help debug issues with service deployments.

In the following figure, Marathon™ has failed to launch a service; DC/OS displays a warning message and then a message stating that the error has cleared and that the service is now launching.

Failure warning

Figure 4 - Debug tab showing warning

For more information about deploying services, see the Deploying Services and Pods documentation.