RoadRunner
  • 🟠General
    • What is RoadRunner?
    • Features
    • Quick Start
    • Installation
    • Configuration
    • Contributing
    • Upgrade and Compatibility
  • 👷PHP Worker
    • Worker
    • Workers pool
    • Developer mode
    • Code Coverage
    • Debugging
    • Environment
    • Manual workers scaling
    • Auto workers scaling
    • RPC
  • 🟢Customization
    • Building RR with a custom plugin
    • Integrating with Golang Apps
    • Writing a Middleware
    • Writing a Jobs Driver
    • Writing a Plugin
    • Events Bus
  • 🔌Plugins
    • Intro into Plugins
    • Centrifuge (WebSockets)
    • Service (Systemd)
    • Configuration
    • Server
    • Locks
    • gRPC
    • TCP
  • 🌐Community Plugins
    • Intro into Community Plugins
    • Circuit Breaker
    • SendRemoteFile
    • RFC 7234 Cache
  • 🔵App Server
    • Production Usage
    • RoadRunner with NGINX
    • RR as AWS Lambda
    • Docker Images
    • CLI Commands
    • Systemd
  • 🔐Key-Value
    • Intro into KV
    • Memcached
    • In-Memory
    • BoltDB
    • Redis
  • 📦Queues and Jobs
    • Intro into Jobs
    • Google Pub/Sub
    • Beanstalk
    • In-Memory
    • RabbitMQ
    • BoltDB
    • Kafka
    • NATS
    • SQS
  • 🕸️HTTP
    • Intro into HTTP
    • Headers and CORS
    • Proxy IP parser
    • Static files
    • X-Sendfile
    • Streaming
    • gzip
  • 📈Logging and Observability
    • OpenTelemetry
    • HealthChecks
    • Access Logs
    • AppLogger
    • Metrics
    • Grafana
    • Logger
  • 🔀Workflow Engine
    • Temporal.io
    • Worker
  • 🧩Integrations
    • Migration from RRv1 to RRv2
    • Spiral Framework
    • Yii
    • Symfony
    • Laravel
    • ChubbyPHP
  • 🧪Experimental Features
    • List of the Experimental Features
  • 🚨Error codes
    • CRC validation failed
    • Allocate Timeout
  • 📚Releases
    • v2025.1.1
    • v2025.1.0
    • v2024.3.5
    • v2024.3.4
    • v2024.3.3
    • v2024.3.2
    • v2024.3.1
    • v2024.3.0
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. Logging and Observability

Access Logs

PreviousHealthChecksNextAppLogger

Last updated 1 year ago

Was this helpful?

RoadRunner has the HTTP access logs support, which provides detailed information about incoming HTTP requests and responses.

This feature is disabled by default, but it can be easily enabled by configuring the HTTP server.

Enabling HTTP Access Logs

To enable HTTP access logs in RoadRunner, you need to modify the configuration file of the HTTP server.

Here's an example configuration file:

.rr.yaml
version: "3"

http:
  address: 127.0.0.1:8000
  access_logs: true
  # ...

Once enabled, RoadRunner will log the following information for each incoming HTTP request:

  • method - HTTP method of the request

  • remote_addr - Remote address of the client

  • bytes_sent - Content length of the response

  • http_host - Host name of the server

  • request - Query string of the request

  • time_local - Local time of the server in Common Log Format

  • request_length - Request body size including headers in bytes (content-len + size of all headers) in bytes. Max allowed headers size for the RR is 1MB.

  • request_time - Request processing time in seconds with a milliseconds' resolution

  • status - HTTP response status

  • http_user_agent - HTTP user string of the client

  • http_referer - HTTP string of the client

📈
agent
referer