Conductor Documentation

Studio Conductor System Processes and Logging Guide

The purpose of this document is to provide detailed information for:

Studio Conductor System Processes

In a Conductor Manager environment, the following system processes exist:

User Command Description
cfyuser nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf Nginx web server (REST API) root process
nginx nginx: worker process Nginx web server (REST API) child process
stage_u+ /usr/bin/npm –prefix /opt/cloudify-stage/backend run start React.js web application (Conductor Management Console)
composer_u+ /usr/bin/npm –prefix /opt/cloudify-composer/backend run start React.js web application (Conductor Composer)
amqpinf+ /opt/amqpinflux/env/bin/python /opt/amqpinflux/env/bin/cloudify-amqp-influxdb cloudify-specific RabbitMQ-to-InfluxDB transport
rabbitmq su rabbitmq -s /bin/sh -c /usr/lib/rabbitmq/bin/rabbitm q-server RabbitMQ service
cfyuser /opt/manager/env/bin/python /opt/manager/env/bin/gunicorn Gunicorn HTTP server
postgres /usr/pgsql-9.5/bin/postgres -D /var/lib/pgsql/9.5/data PostgreSQL database

Studio Conductor Systemd Init Services

Service Description
cloudify-mgmtworker Conductor Manager management worker
cloudify-rabbitmq RabbitMQ service
cloudify-restservice Conductor REST service
cloudify-stage Conductor Management Console service
cloudify-composer Conductor Composer service
cloudify-check-runner.service check runner
cloudify-handler-runner.service handler runner
cloudify-postgresql.service PostgreSQL 9.5 database server
cloudify-syncthing.service Files syncthing

Conductor Service Configuration Defaults

All Studio Conductor-specific service configurations can be found in /etc/sysconfig. This area is where default configuration data can be found as well as logging locations for service-specific troubleshooting. These are very useful when trying to understand how a service was instantiated and what logging configuration is being used.

This directory can also be used to derived each core service’s Systemd init name. For instance, enumerating /etc/sysconfig will show a file called cloudify-stage. This is the name of the service, and thus to query the service status can be done using the command service cloudify-stage status.

Discovering Studio Conductor Services

Service Statuses

The sections above describe how to identify a Studio Conductor service by looking directly at the output
of something like ps or by folder snooping. This is not always practical or desired and there are
other, more developer-friendly, ways of enumerating which Studio Conductor services are present and
how to harvest information about them.

The best starting point is to utilize the REST API of the manager to get service information.
Simply craft a GET request for the status endpoint: GET /status HTTP/1.1
If cURL and Python are available, it’s very easy to make the request as well as visualize the
returned data.

Code Block 1 REST

curl -X GET http://<manager-ip>/status | python -m json.tool

An example, partial, return is as follows:

Code Block 2 JSON

{
"services": [{
"display_name": "RabbitMQ",
"instances": [{
"ActiveState": "active",
"Description": "RabbitMQ Service",
"Id": "cloudify-rabbitmq.service",
"LoadState": "loaded",
"MainPID": 12322,
"SubState": "running",
"state": "running"
}
]
}

With this information, in standard JSON format, it is easy to match a core Studio Conductor service with a
system-level process ID (MainPID) to begin further troubleshooting.

Cluster status

Studio Conductor provides system health information for both single box deployments and clustered deployments. Read more about it:

Checking Manager Components

RabbitMQ

System Service

To check if the RabbitMQ broker is running (and to see many other details such as which applications are running, memory allocation, and other performance metrics), simply run the following command:

Code Block 7 bash

sudo rabbitmqctl -n cloudify-manager@localhost status

An error message will be presented if the service has an issue such as a failed broker.

Management Operations

To get started working with the RabbitMQ management interface, the management interface must be enabled via a plugin. Execute the following to enable the management plugin:

sudo rabbitmq-plugins -n cloudify-manager@localhost enable rabbitmq_management

Once this is complete, there will be a management web interface located at http://:15672/

In order to utilize the web interface, you will need to have the RabbitMQ username and password for authentication. This can be found in the /etc/cloudify/config.yaml file used for instantiation a Conductor Manager.

By default, the user created from the manager instantiation process does not have sufficient permissions to be used with the web interface. Use the following command to promote the default user with the “monitoring” permission (or you can alternatively assign the “administrator” tag).

sudo rabbitmqctl set_user_tags <username> monitoring

You can now use the RabbitMQ username and password to log in via the web interface to do actions such as view queues, get messages, monitor performance, and monitor connections.

PostgreSQL

System Service

To verify if postgres is working correctly a simple select can be executed:

Code Block 10 bash

sudo -u postgres psql --port 15432 -c "select 1"

Syncthing

Checking if syncthing is working correctly will need a curl command to the REST API.

Code Block 12 REST

curl -H "X-Api-Key: <key>" 127.0.0.1:8384/rest/system/status

The key can be gathered from: //configuration/gui/apikey in /opt/syncthing/.config/syncthing/config.xml

Logging

Overview

Log locations vary from service to service, but the majority of logs can be found in /var/log and /var/log/cloudify.

Within these folders are folders for each service with distinguishable names such as “rabbitmq” and “postgres”. If logs for a service aren’t found here, the next place to look would be in the service configuration defaults file for any indication of a log file path (see the section “Studio Conductor Service Configuration Defaults”).

Studio Conductor Agent Worker Logs

Studio Conductor agent worker logs can be found on deployed instances / virtual machines with an installed Studio Conductor agent. Typically, the logs are stored in the Studio Conductor agent user’s home directory in a folder named after the node instance ID for the instance / VM.

Studio Conductor Management Worker Logs

Studio Conductor Management Worker Logs

Studio Conductor REST API Service Logs

PostgreSQL Logs

RabbitMQ Logs

Cluster Logs