Skip to content

Latest commit

 

History

History
64 lines (46 loc) · 3.67 KB

accesslogserver.md

File metadata and controls

64 lines (46 loc) · 3.67 KB

Intro

Accesslogserver is the access logger receiver for envoyproxy.

how to enable

Set the attribute AccessLogCluster on a listener to enable envoyproxy to stream accesslogs.

accesslogserver endpoints

Accesslogserver exposes two endpoints:

name scope protocol purpose
webadmin private http admin console, prometheus metrics, etc
accesslog private grpc access log receive from envoyproxy

Both webadmin.listen and accesslog.listen should be set to configure listening address and port.

Scope:

  • private, must not be exposed outside the deployment itself

Deployment

Configuration

Accesslogserver requires a starup configuration which needs to be provided as YAML file, see below for the supported fields. For an example configuration file see accesslogserver.yaml.

Logfiles

Accesslogserver writes multiple logfiles, one for each function of accesslogserver. All are written as structured JSON, filename rotation schedule can be set via configuration file. The three logfiles are:

  1. logger.filename as log for application messages
  2. webadmin.logger.filename as access log for all REST API calls
  3. accesslog.logger.filename as access log entries received from envoy

Accesslogserver configuration file

The supported fields are:

yaml field purpose example
logger.level application log level info / debug
logger.filename filename to write application log to /dev/stdout
logger.maxsize Maximum size in megabytes before rotate 100
logger.maxage Max days to retain old log files 7
logger.maxbackups Maximum number of old log files to retain 14
webadmin.listen Webadmin address and port 0.0.0.0:6002
webadmin.ipacl Webadmin ip acl, without this no access 172.16.0.0/19
webadmin.tls.certfile TLS certificate file
webadmin.tls.keyfile TLS certificate key file
webadmin.logger.level logging level of webadmin info / debug
webadmin.logger.filename filename to write web access log to managementserver-access.log
webadmin.logger.maxsize Maximum size in megabytes before rotate 100
webadmin.logger.maxage Max days to retain old log files 7
webadmin.logger.maxbackups Maximum number of old log files to retain 14
accesslog.listen accesslog address and port 0.0.0.0:6001
accesslog.maxstreamduration max envoy stream duration 10m
accesslog.logger.level accesslog log level, not used info / debug
accesslog.logger.filename filename to write access log to /dev/stdout
accesslog.logger.maxsize Maximum size in megabytes before rotate 100
accesslog.logger.maxage Max days to retain old log files 7
accesslog.logger.maxbackups Maximum number of old log files to retain 14