Log Aggregation Service (LAS)

EPAM Cloud Orchestrator provides the users with a GrayLog-based Log Aggregator Service
that collects the logs from the specified instances and gives an easy and visual access to them via a
web-interface. The service is based on GrayLog v.1.0 released in February 2015.

Have a Question?

The current page gives the general information on the service and the main workflows. However, while working with the
services, our users encounter new questions they need assistance with. The most frequently asked questions on EPAM Cloud
Services are gathered on the
Cloud Services FAQ page.
Visit the page to check whether we have a ready answer for your question.

Related CLI Commands

The table below provides the list of service-related commands and their descriptions:

Command

Short Command

Description

or2-manage-service ... -s log -a

or2ms ... -s log -a

Starts the service in the specified project and region

or2-start-logging

or2log

Start collecting logs from the specified instance

or2-describe-logging

or2dlog

Describes the log aggregation service of the project

or2-stop-logging

or2stoplog

Stops collecting logs from the specified instance

Further on this page, you can find the examples of the commands usage for Log Aggregation Service manipulation.

Service Activation

To start the service, use the or2-manage-service command with the following parameters:

or2ms -p project -r region -s log --activate

Here, the -s parameter specifies the name of the service to manage (log), and the --activate parameter
indicates that the service should be activated (to stop the service, use --deactivate).

During the service activation, a VM with is started and a GrayLog server is configured on it. The server setup is a
complicated process and can take up to an hour. If the project already has a GrayLog Server,
you will get the respective error message.

Service Manipulations

EPAM Orchestrator supports the following commands for Log service manipulations:

When the server is activated, you can start adding instances to the logging list, which allows to collect logs from these
instances. This is done with the or2-start-logging (or2log) command:

or2log -p project -r region -i instance_id

To get the list of the logged instances and the DNS name of the GrayLog Server, use the or2-describe-logging (or2dlog)command:

or2dlog -p project -r region

To remove the instance from the Logging Service list, use the or2-stop-logging (or2stoplog) command:

or2stoplog -p project -r region -i instance_id

The server stops collecting the instance log data, but all the logs, previously aggregated, are kept.

To stop the log aggregation service and remove the GrayLog Server VM, run the following command:

or2ms -p project -r region -s log --deactivate

Web UI and Viewing Logs

You can view the collected logs by connecting to the Log Server via HTTP.
The typical address template for connecting to Log Server is:

http://<LogServerInstanceDNS>

The login and password that are to be used during the login to the server are returned at or2-describe-services command call:

When you log in, you will get to GrayLog Web Interface that provides you with the full access to the gathered
data.

Pricing

The service usage price is defined by the price of the GrayLog Server VM.

The default parameters of a GrayLog Server VM are:

Shape: MEDIUM

Image: Ubuntu14.04_64-bit

Therefore, the approximate monthly cost of a GrayLog Server usage in case of 100% and 24/7 load is about $58.59 in EPAM-BY1 region (as to 11/09/2015).
The price can vary depending on the region.
To get more detailed estimations, please, use our Cost Estimator tool.