Mezmo Agent

Description

The Mezmo Agent Pipeline Source enables streaming of log data from the Mezmo Agent directly to your Pipeline.

Mezmo Agent Configuration

Environment Variable Name	Yaml Variable Name	Description
MZ_ENDPOINT	http.endpoint	Path of your Pipeline. For all Pipelines this should be set to /v1/<YOUR ROUTE ID>
MZ_HOST	http.host	The ingest endpoint for your Pipeline. Should be a value similar to pipeline.mezmo.com
MZ_INGESTION_KEY	http.ingestion_key	This is the access key to your Pipeline.
MZ_INGEST_BUFFER_SIZE	http.body_size	Limit the body size per request in bytes (please configure to 1000000 or less)

Migrating from Log Analysis

Please upgrade your Agent version to 3.9 or above before starting your migration to Pipeline ingestion. You may already have similar variables configured to point to your log analysis endpoint (prefixed with LOGDNA_). Just update these settings to the values in the table with values provided by your Pipeline setup. Please note the MZ_prefix is only supported for Agent version 3.7+.

You can find more information about Agent settings in the Agent GitHub repo.

For complete information on setting up and configuring the OpenTelemetry Export for Mezmo log ingestion, check out the GitHub repo for the mezmoexporter.

Installing via Helm

If your cluster is managed with Helm, you can also install the Mezmo Agent for Pipeline using Helm. Utilizing the same information above, you can set these environment variables using the extraEnv attribute.

In the YAML file example shown here, replace <YOUR_PIPELINE_INGEST_KEY> with the key you obtained when setting up the Agent source in your Pipeline. When using the environment variables shown in the Configuration section, this is also the same value you would set for MZ_INGESTION_KEY.

helm repo add logdna https://assets.logdna.com/charts
helm install --set 'logdna.key=<YOUR_PIPELINE_INGEST_KEY>,extraEnv[0].name=MZ_ENDPOINT,extraEnv[0].value=/v1/YOUR_PIPELINE_ID,extraEnv[1].name=MZ_HOST,extraEnv[1].value=pipeline.mezmo.com,extraEnv[2].name=MZ_INGEST_BUFFER_SIZE,extraEnv[2].value=1000000'  my-release logdna/agent

Or using a values.yaml

logdna:
  key: <YOUR_PIPELINE_INGEST_KEY>
extraEnv:
  - name: MZ_HOST
    value: pipeline.mezmo.com
  - name: MZ_INGEST_BUFFER_SIZE
    value: 1000000
  - name: MZ_ENDPOINT
    value: /v1/<YOUR ROUTE ID>

helm repo add logdna https://assets.logdna.com/charts
helm install -f ./values.yaml my-release logdna/agent