# logmatic: Send logs to Logmatic.io

The `logmatic()` destination sends log messages to the [Logmatic.io](<https://logmatic.io/>) Logging-as-a-Service provider. You can send log messages over TCP, or encrypted with TLS.

## Declaration:
```
       logmatic(token());
    
```

## Example: Using the logmatic() driver

To use the logmatic() destination, the only mandatory parameter is your user token. The following example sends every log from the `system()` source to your Logmatic.io account.
```
 
       log {
            source { system(); };
            destination { logmatic(token("<API-KEY-AS-PROVIDED-BY-LOGMATIC.IO>")); };
        };
    
```

The following example uses TLS encryption. Before using it, download the CA certificate of Logmatic.io and copy it to your hosts (for example, into the `/etc/ssl/certs/` directory.
```
 
       log {
            destination {
                logmatic(token("<API-KEY-AS-PROVIDED-BY-LOGMATIC.IO>") port(6514)
                    tls(peer-verify(required-trusted) ca-dir('/etc/ssl/certs'))
                );
            };
        };
    
```

The following example parses the access logs of an Apache webserver from a file and sends them to Logmatic.io in JSON format.
```
 
       log {
            source { file("/var/log/apache2/access.log" flags(no-parse)); };
            parser { apache-accesslog-parser(); };
            destination {
                logmatic(token("<API-KEY-AS-PROVIDED-BY-LOGMATIC.IO>")
                   tag(apache)
                   template("$(format-json .apache.* timestamp=${ISODATE})"));
            };
        }
    
```

To use the `logmatic()` driver, the `scl.conf` file must be included in your AxoSyslog configuration:
```
 
       @include "scl.conf"
    
```

The `logmatic()` driver is actually a reusable configuration snippet configured to send log messages using the `tcp()` driver using a template. For details on using or writing such configuration snippets, see [Reusing configuration blocks](../../docs/axosyslog-core/chapter-configuration-file/large-configs/config-blocks/index.md). You can find the source of this configuration snippet on [GitHub](<https://github.com/axoflow/axosyslog/blob/master/scl/logmatic/logmatic.conf>).

* * *

[logmatic() destination options](../../docs/axosyslog-core/chapter-destinations/configuring-destinations-logmatic/reference-destination-logmatic/index.md)

Last modified June 4, 2024: [More github link updates (13f3206e)](<https://github.com/axoflow/axosyslog-core-docs/commit/13f3206e659157ec0efc7371296867db7371b637>)