{"id":20710897,"url":"https://github.com/entur/cloud-logging","last_synced_at":"2025-04-23T06:19:45.567Z","repository":{"id":213556818,"uuid":"659902803","full_name":"entur/cloud-logging","owner":"entur","description":"Logging for the JVM","archived":false,"fork":false,"pushed_at":"2025-03-26T14:39:03.000Z","size":993,"stargazers_count":5,"open_issues_count":6,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T22:31:30.450Z","etag":null,"topics":["gcp","grpc","junit5","logback","micrometer","slf4j"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"eupl-1.2","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/entur.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-28T20:19:32.000Z","updated_at":"2025-03-26T14:39:06.000Z","dependencies_parsed_at":"2023-12-21T18:29:53.371Z","dependency_job_id":"acc29bed-8a48-4e80-bc0d-b4b66c64cc06","html_url":"https://github.com/entur/cloud-logging","commit_stats":null,"previous_names":["entur/cloud-logging"],"tags_count":42,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entur%2Fcloud-logging","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entur%2Fcloud-logging/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entur%2Fcloud-logging/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/entur%2Fcloud-logging/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/entur","download_url":"https://codeload.github.com/entur/cloud-logging/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250380077,"owners_count":21420885,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gcp","grpc","junit5","logback","micrometer","slf4j"],"created_at":"2024-11-17T02:13:28.843Z","updated_at":"2025-04-23T06:19:45.561Z","avatar_url":"https://github.com/entur.png","language":"Java","readme":"[![Maven Central](https://img.shields.io/maven-central/v/no.entur.logging.cloud/api.svg)](https://mvnrepository.com/artifact/no.entur.logging.cloud)\n\n# cloud-logging\nLogging libraries for JVM applications. Goals\n\n * make developers more productive when developing and maintaining applications\n * keep cloud logging costs within reason\n * help comply with privacy constraints for logging\n\nFeatures:\n\n * SLF4J `Logger`-wrapper for additional error levels\n * Plug and play logging scheme\n   * Main scope (for production):\n     * Machine-readable JSON\n   * Test scope (for local development). Log output can be toggled at runtime:\n     * Human-readable 'classic' (one-line + ANSI colors, enabled by default), or\n     * Human-readable JSON (pretty-printed + ANSI colored), or\n     * Machine-readable JSON (single line)\n * Request-response-logging\n     * Logbook style output (i.e. inlined in JSON log statements)\n     * Additional ANSI coloring for test scope\n * Selective 'on-demand' logging for unexpected web server behaviour\n     * capture full logs for problematic requests (i.e. not only WARN or ERROR, but also all sibling INFO log statements). Triggers:\n        * HTTP status code\n        * Log level (i.e. if ERROR logged, also log sibling INFO statements)\n        * Call duration\n        * Header present\n        * Manual signalling\n     * reduce cost of logging considerably\n * Unit testing\n   * Always assert against machine-readable JSON 'under the hood', regardless what is printed to console during local development\n   * Supported frameworks\n     * JUnit 5\n * Correlation-id tracing\n\nThis library is mostly based on\n\n * SLF4J 2\n * Logback + Logback logstash\n * GRPC\n   * [Ecosystem](https://github.com/grpc-ecosystem/grpc-spring)\n * [Logbook](https://github.com/zalando/logbook)\n\nSupported web technologies are:\n\n * Spring web\n * Spring + gRPC\n\nSupported clouds:\n\n * GCP (Stackdriver)\n * Azure\n\n# License\n[European Union Public Licence v1.2](https://eupl.eu/).\n\n# Usage\n\n## Overview\nThis project contains Spring boot starters which allows for property-based configuration:\n\n * base configuration (required)\n * request-response-logging (optional)\n * on-demand-logging (optional)\n\nEach Spring Boot starter has a corresponding Spring Boot test starter. The Spring boot test starters enhance the developer experience during local development. \n\nThe above starters are implemented in two flavours:\n\n * Servlet-based web\n * Netty-based gRPC\n\n## Getting started\nSee [Getting started with gRPC](guides/gRPC.md) or [Getting started with servlet-based web](guides/web.md). Alternatively, go directly to the [examples](examples).\n\n# Roadmap\n\n * Replace the correlation-id tracing artifacts with standardized modern equivalents, i.e. span id and so on.\n * Better define and tune request-response logging JSON format\n    * Add support for other text formats\n    \n# See also\n\n * [logback-logstash-syntax-highlighting-decorators](https://github.com/entur/logback-logstash-syntax-highlighting-decorators)\n\n\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentur%2Fcloud-logging","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fentur%2Fcloud-logging","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fentur%2Fcloud-logging/lists"}