Information for: DEVELOPERS   PARTNERS   SUPPORT

Looking for something?

Streaming log entries in real time

Important

  • This feature is temporarily limited to load balancer logs only for environments running on Cloud Next technologies.
  • Avoid using log streaming for persistent log transmission to internal or third-party log retention services. If you require this feature, contact your Account Manager to purchase Acquia’s Log forwarding service.

Besides downloading log files from the Cloud Platform interface or accessing logs using command-line tools, you can also stream logs in real time using the Cloud Platform interface on the Applications > [Environment] > Logs page. The Logs page stream shows log entries from all the logs of an environment at once. In contrast, each of the log files you can download shows a single log from an infrastructure (aside from the Drupal watchdog log and the MySQL slow query log).

Node.js applications and log streaming

Enclose your Node.js application in error-handling code that captures error information through console.log() or console.error() for log and error message display in Log Streaming.

There are several methods you can use to modify which log entries are streamed:

  • Click Stream to select which logs are the source of log entries to be streamed. By default, the PHP error and Apache error logs are enabled.

    Streaming logs

  • Filter the log stream using JavaScript regular expressions. Type a regular expression and the log stream is filtered accordingly.

  • If you click a log entry or scroll down the log stream, new entries are not added to the display. Click Show new messages to return to the top of the log stream and show the most recent log entries.

  • Click Pause to pause the log stream, and Restart to restart the log stream. When you restart the log stream after pausing it, the Logs page displays current log entries and doesn’t display all the entries that occurred while it was paused.

  • To clear all the log entries, click Clear.

  • To download a log file, select Logs > Download. For more information, see Downloading active log files from the Logs page.

    Downloading logs

Color coding for log entries

Log entries are displayed with different colored bars at the left margin:

Log source Bar color
Apache error Red
Apache request Yellow
Balancer request Green
Drupal request Yellow
MySQL slow query Red
Node.js error Red
PHP error Red
Varnish® request Green

Streaming logs from the command line

In addition to streaming logs on the Logs page, you can use the Logstream Ruby gem, which provides a client-side API library and command-line interface. Learn more about how to install and use Logstream.

Note

The Cloud Platform log streaming Chrome extension, although available as a Chrome extension, is not supported.

53 State Street, 10th Floor
Boston, MA 02109
United States
Phone: 888-922-7842