agent-architecture.html.md.erb

---
title: Log and Metric Agent architecture (Beta)
owner: Log Egress, Metric Egress
---

The Log and Metric Agent Architecture (Beta) contains a group of components that allow you to access all the same logs and
metrics that you can through the Loggregator system in Cloud Foundry.

<p> The Log and Metric Agent Architecture (Beta) does not
currently integrate with Healthwatch or App Metrics.</p>

The components of the Log and Metric Agent Architecture use a shared-nothing architecture that requires several fewer VMs than the Loggregator system.

The Log and Metric Agent Architecture includes components that collect, store, and forward logs and metrics in your <%= vars.platform_name %> deployment.

For more information about the components of Loggregator, see [Loggregator Architecture](architecture.html).

## <a id="metric-egress"></a> Metric components

This section tells you about the components of the Log and Metric Agent Architecture that allow you to access metrics for your foundation.

These components allow you to access the same metrics available through the Loggregator Firehose with a pull based architecture. The Loggregator system uses a push-based model for forwarding metrics, in which all data is sent though the Firehose.

The following components of the Log and Metric Agent Architecture activate pull based access to metrics:

* **Metrics Agent**: <br>The Metrics Agent collects Loggregator V2 envelopes and makes them available on a Prometheus endpoint. The Metrics Agent performs a similar function to the Loggregator Agent in the Loggregator system.

* **Service Metrics Agent**: <br>The Service Metrics Agent receives metrics from service instances on your <%= vars.platform_name %> deployment and makes them available on a Prometheus endpoint.

* **Metrics Discovery Registrar**: <br>The Metrics Discovery Registrar publishes the location of the Prometheus endpoint defined by the Metrics Agent and Service Metrics Agent to NATs. This is helpful for configuring automation to scrape metric data from the endpoint. For more information about automating metric scraping, see [Telegraf Reference Architecture (Beta)](#telegraf-reference-architecture).

## <a id="log-egress"></a> Log components

This section tells you about the Log and Metric Agent Architecture components that allow you to access logs on your foundation.

These components are also a part of the Loggregator system. For more information about how these components function as part of the Loggregator system, see [Loggregator Architecture](architecture.html).

The following components of the Log and Metric Agent Architecture activate access to logs:

* **Syslog Agent**:<%= partial 'syslog_agents' %>

* **Aggregate Syslog Drain**: <br>The aggregate syslog drain feature allows you to configure all Syslog Agents on your deployment to send logs to a single destination. You can use the aggregate syslog drain feature rather than the Loggregator Firehose to forward all logs for your deployment.

* **Log Cache**: <%= partial 'log_cache' %>