morgan (software)

morgan (software)
Name	morgan
Title	morgan

morgan (software) morgan is a middleware library for HTTP request logging commonly used in web application stacks. It integrates with frameworks and servers for logging HTTP transactions and is often paired with web frameworks, application servers, logging systems, and observability tools. morgan is designed to produce configurable log output suitable for ingestion by log processors, monitoring platforms, and analysis pipelines.

Overview

morgan operates as middleware between HTTP servers and application logic in environments using Node.js, Express, Connect, Koa, Fastify adapters, and other JavaScript-based servers. It focuses on producing access logs compatible with tools like Logstash, Fluentd, Graylog, Splunk, Elasticsearch, Kibana, Grafana and Prometheus exporters when paired with exporters or translators. Developers commonly deploy morgan alongside package managers such as npm and Yarn in CI/CD pipelines run by Jenkins, GitHub Actions, GitLab CI/CD, or CircleCI.

Features

morgan provides pluggable logging formats and runtime configuration to work with observability stacks like OpenTelemetry, Jaeger, and Zipkin. It supports predefined tokens corresponding to HTTP attributes from RFC 7231 and network metadata used by proxies such as NGINX, HAProxy, and Traefik. Custom token functions enable integration with authentication systems like OAuth 2.0, OpenID Connect, and identity providers including Okta, Auth0, and Keycloak. The library emits logs to standard streams compatible with container runtimes such as Docker and orchestration platforms like Kubernetes, facilitating collection by agents like Filebeat, Vector, and Prometheus Node Exporter in observability pipelines.

Architecture and Design

morgan is implemented as a middleware function that hooks into the request-response lifecycle of event-driven servers such as Node.js and interoperates with frameworks including Express and Connect. Its token-based formatter design mirrors patterns used in Apache HTTP Server and nginx access log configurations, enabling format strings and custom token registration. The design emphasizes non-blocking I/O consistent with the libuv architecture underlying Node.js, and minimizes overhead for high-concurrency environments like microservices deployed on AWS Lambda, Azure Functions, or Google Cloud Functions. Output sinks are intentionally decoupled to integrate with logging libraries such as Winston, Bunyan, and Pino.

Usage and Command-line Interface

morgan is primarily used as a programmatic middleware and does not expose a dedicated CLI; instead it is configured in application codebases managed via npm scripts, Makefile targets, or container entrypoints orchestrated by systemd on virtual machines or by Kubernetes manifests in clusters. Typical integration examples show usage within an Express application where middleware ordering, environment variables (for example from dotenv), and conditional logging are controlled by configuration management tools such as Ansible, Terraform, or Chef. Developers use linters like ESLint and formatters such as Prettier to enforce code quality when importing and configuring morgan in repositories hosted on platforms like GitHub, GitLab, or Bitbucket.

Development and Version History

morgan's source history is managed in distributed version control systems, typically hosted on platforms such as GitHub where pull requests, issues, and release notes coordinate development. Versioning follows Semantic Versioning conventions adopted by many open-source projects and integrates with continuous integration pipelines powered by Travis CI or GitHub Actions for automated testing against Node.js release lines. Maintenance often involves dependency updates for modules in the npm ecosystem and security advisories coordinated through communities and organizations like the OpenJS Foundation.

Reception and Use Cases

morgan has been adopted in web applications ranging from small APIs and single-page application backends to larger microservice architectures in enterprises using platforms such as Heroku, DigitalOcean, Amazon Web Services, Microsoft Azure, and Google Cloud Platform. It is recommended in tutorials, books, and learning resources alongside Express in curricula from coding schools, bootcamps, and documentation referenced by developers in forums such as Stack Overflow and communities on Reddit and Dev.to. Use cases include access logging for compliance with standards like PCI DSS where audit trails are required, performance diagnostics linked to New Relic, Datadog, and security monitoring with OSSEC or Wazuh.

Category:Node.js software