Skip to content

cloudfoundry/loggregator-agent-release

Repository files navigation

Loggregator Agent Release

A collection of composable agents used for interacting with Loggregator and Syslog

If you have any questions, or want to get attention for a PR or issue please reach out on the #logging-and-metrics channel in the cloudfoundry slack

Agents Architecture

architecture

UDP Forwarder

Accepts the Loggregator v1 api over UDP and forwards it to a downstream Loggregator v2 consumer. This is available for backwards compatibility between the v1 API and the Forwarder, Syslog, or Loggregator agents.

Forwarder Agent

A Loggregator v2 api multiplexer. This Agent Accepts Loggregator v2 and forwards to other agents colocated on the same VM that accept Loggregator v2. To configure downstream agents, simply place a file named ingress_port.yml in the job's config directory. example

Syslog Agent

An agent that forwards app logs to a syslog drain. Drains are registered by binding User Provided Services to apps. Any logs coming from a registered app are forwarded to the configured endpoint. docs

Syslog Binding Cache

Syslog Agents can overwhelm CAPI when querying for existing bindings. This component acts a a proxy for the CAPI Binding query.

Loggregator Agent

Loggregator Agent is a Cloud Foundry component that forwards logs and metrics into the Loggregator subsystem. More information can be found in the docs

Prom Scraper

A simple agent that reads from any local prometheus-scrapable endpoint and forwards the results to Loggregator. Configurable via files in colocated bosh jobs as described in the docs scrapes are avoided in an HA environment.

OTel Collector

This is the Cloud Foundry distribution of the OTel Collector. It can be found in the otel-collector-release repo. It accepts metrics in OTLP format and forwards them to any configured exporters. More information can be found in the OpenTelemetry docs

More Resources and Documentation

Feedback

We are always looking to gather feedback and input from Loggregator operators. Get in touch or file an issue if you have feature suggestions you'd like to see added.