package logs-syslog

All checked builds pass
  1. Overview
  2. Docs
Logs reporter to syslog (UDP/TCP/TLS)

Install 

dune-project
 Dependency

github.com Readme Changelog ISC License Edit opam file Versions (1)

Authors

  1. H
    Hannes Mehnert <hannes@mehnert.org>

Maintainers

  1. H
    Hannes Mehnert <hannes@mehnert.org>

Sources

logs-syslog-0.5.0.tbz
sha256=af1ee692c03ccb5042122b0d4d0c12b0969eb78d9e47bb59de0633bc2aab60d4
sha512=199b34bdc86ce1cad91d9458b67db999cd1cad23c1ea1568ec0349ee3b4cd3bd526ccd5fa51774dd7e3dd0f750938df2e46e08717da3190d37a1e7f5cec701e3

Description

This library provides log reporters using syslog over various transports (UDP, TCP, TLS) with various effectful layers: Unix, Lwt, MirageOS. It integrates the Logs library, which provides logging infrastructure for OCaml, with the syslog-message library, which provides encoding and decoding of syslog messages (RFC 3164).

Added to opam-repository:

README

Logs-syslog - Logs output via syslog

v0.5.0

This library provides log reporters using syslog over various transports (UDP, TCP, TLS) with various effectful layers: Unix, Lwt, MirageOS. It integrates the Logs library, which provides logging infrastructure for OCaml, with the syslog-message library, which provides encoding and decoding of syslog messages (RFC 3164).

Six ocamlfind libraries are provided: the bare Logs-syslog, a minimal dependency Unix Logs-syslog-unix, a Lwt one Logs-syslog-lwt, another one with Lwt and TLS (RFC 5425) support Logs-syslog-lwt-tls, a MirageOS one Logs-syslog-mirage, and a MirageOS one using TLS Logs-syslog-mirage-tls.

Since MirageOS3, syslog is well integrated:

let logger =
  syslog_udp
    (syslog_config ~truncate:1484 "nqsb.io" (Ipaddr.V4.of_string_exn "192.168.0.1"))
    net
...
  register "myunikernel" [
    foreign
      ~deps:[abstract logger]

Documentation

Build Status

API documentation is available online.

Installation

This is targeting other libraries (apart from syslog-message) which are released to opam-repository.

opam pin add syslog-message --dev-repo
opam pin add logs-syslog https://github.com/hannesm/logs-syslog.git

Dependencies (5)

  1. syslog-message >= "1.0.0"
  2. ptime
  3. logs >= "0.5.0"
  4. dune >= "1.1.0"
  5. ocaml >= "4.03.0"

Dev Dependencies

None

Used by (2)

  1. albatross >= "2.1.0"
  2. ocsigenserver >= "7.0.0"

Conflicts (4)

  1. tls-mirage < "2.0.0"
  2. tls-lwt < "2.0.0"
  3. tcpip < "9.0.0"
  4. mirage-kv < "3.0.0"

Build status

Results of building logs-syslog with each compiler on check.ci.ocaml.org, run of against opam-repository 8a77e58. All results for this package.

Each result links to its build log. To keep crawlers from overloading the site, build logs require a GitHub sign-in (see ocurrent/opam-health-check). On your first log, GitHub asks you to “Authorize opam-health-check”, the OCurrent app that runs these checks; it sees only your public profile, not your repositories. The sign-in lasts 30 days.

Version OCaml 4.11 OCaml 4.14 OCaml 5.2 OCaml 5.4 OCaml 5.5
0.5.0 (this version) good good good good good
  • good Package successfully built
  • partial One of the dependencies failed to build
  • bad Package failed to build
  • n/a Package is not available in this environment
  • internal Internal failure