Skip to content

Log Shippers

Using the FusionReactor agent, you can send additional logs hosted on your servers themselves with only minor configuration.

However, there are some drawbacks to this approach:

  • Sending logs using a process running within your application can reduce performance if there is a high volume of logs.

  • Scraping logs does not allow you to apply custom labels to logs.

  • To get the most value out of logging you also want to send logs from alternate servers.

Alternative sources could be:

  • Application server logs (eg ColdFusion, Tomcat, Lucee)

  • Nginx logs

  • Database logs

  • IIS logs

  • Proxies

  • Docker logs

Sending logs

Use a logging client such as Promtail, fluent Bit, LOGBack, Fluentd or some other alternative.

alt alt alt alt

Send logs directly to FusionReactor Cloud by configuring the log destinations with the following URL, using basic authentication of username / password.

  • Username = FusionReactor Cloud login email.

  • Password = API key.

Generating API keys

To generate an API key, go to your account settings page in FusionReactor Cloud Account settings.

Under the API keys tab, click generate and create a key.

Sending logs to FR Cloud

Sending Logs to FusionReactor Cloud from FusionReactorAPM on Vimeo.

Sending logs to FR Cloud via Docker

Sending logs to FusionReactor Cloud using Docker from FusionReactorAPM on Vimeo.

Labelling your logs

As you will see in the examples below, all logs must have at least a job label.

Recommended labels:

  • Job

  • Host

  • Filename (if applicable)

Learn more

Labels & fields

Logging client examples

Below are examples of how to use Promtail, fluentbit and LOGBack to scrape logs from a container. We have updated the clients configuration to authenticate against FusionReactor Cloud.


Use the installation docs to install Promtail.

Example: promtail.yml

    http_listen_port: 9080
    grpc_listen_port: 0

    filename: /tmp/positions.yaml

    - url:
    username: {user}
    password: {api key}

    - job_name: nginx
        - targets:
            - localhost
            job: store-balancer
            host: localhost
            __path__: /var/log/nginx/*log

Fluent Bit

Use the install documentation to install Fluent Bit.

Example: fluent-bit.config

        Name        fusionreactor-logs
        Path        /opt/coldfusion2018/cfusion/logs/coldfusion-out.log
        Tag         cfusionout

        Name        fusionreactor-logs
        Path        /opt/coldfusion2018/cfusion/logs/coldfusion-error.log
        Tag         cfusionerr

        Name fusionreactor-logs
        Match cfusionout
        Labels {job="service-name-here",instance="hostname",filename="coldfusion-out.log"}
        LogLevel info

        Name fusionreactor-logs
        Match cfusionerr
        Labels {job="service-name-here",instance="hostname",filename="coldfusion-error.log"}
        LogLevel info


Use the download page to add LOGBack to your application.

Example: logback.xml

        <appender name="FRCLOUD" class="com.github.loki4j.logback.Loki4jAppender">
                    <password>{api key}</password>
                    <pattern>${applicationName} ${}: [%-5level] %logger %mdc - %msg</pattern>

        <appender name="FRCLOUD_ASYNC" class="ch.qos.logback.classic.AsyncAppender">
            <appender-ref ref="FRCLOUD" />

        <root level="INFO">
            <appender-ref ref="FRCLOUD_ASYNC"/>

        <logger name="ROOT" level="INFO"/>
        <logger name="com.intergral" level="INFO"/>


Need more help?

Contact support in the chat bubble and let us know how we can assist.