{"id":43269621,"url":"https://github.com/teamhephy/logger","last_synced_at":"2026-02-01T15:39:36.667Z","repository":{"id":31408620,"uuid":"102786277","full_name":"teamhephy/logger","owner":"teamhephy","description":null,"archived":false,"fork":false,"pushed_at":"2023-09-26T20:30:42.000Z","size":1755,"stargazers_count":0,"open_issues_count":8,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-06-20T19:25:00.005Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/teamhephy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2017-09-07T21:14:26.000Z","updated_at":"2020-06-25T20:22:29.000Z","dependencies_parsed_at":"2022-07-15T19:49:03.631Z","dependency_job_id":null,"html_url":"https://github.com/teamhephy/logger","commit_stats":{"total_commits":120,"total_committers":16,"mean_commits":7.5,"dds":0.55,"last_synced_commit":"ea3476819e0b0886b3347f69b910a1c2458f3fbd"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/teamhephy/logger","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamhephy%2Flogger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamhephy%2Flogger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamhephy%2Flogger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamhephy%2Flogger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/teamhephy","download_url":"https://codeload.github.com/teamhephy/logger/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/teamhephy%2Flogger/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28981373,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T15:35:50.179Z","status":"ssl_error","status_checked_at":"2026-02-01T15:35:38.075Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-02-01T15:39:36.596Z","updated_at":"2026-02-01T15:39:36.651Z","avatar_url":"https://github.com/teamhephy.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Hephy Logger\n[![Build Status](https://ci.deis.io/job/logger/badge/icon)](https://ci.deis.io/job/logger)\n[![codecov.io](https://codecov.io/github/deis/logger/coverage.svg?branch=master)](https://codecov.io/github/deis/logger?branch=master)\n[![Go Report Card](https://goreportcard.com/badge/github.com/deis/logger)](https://goreportcard.com/report/github.com/deis/logger)\n[![Docker Repository on Quay](https://quay.io/repository/deis/logger/status \"Docker Repository on Quay\")](https://quay.io/repository/deis/logger)\n\nHephy - A Fork of Deis Workflow\n\nDeis (pronounced DAY-iss) Workflow is an open source Platform as a Service (PaaS) that adds a developer-friendly layer to any [Kubernetes](http://kubernetes.io) cluster, making it easy to deploy and manage applications on your own servers.\n\n![Deis Graphic](https://getdeis.blob.core.windows.net/get-deis/deis-graphic-small.png)\n\nFor more information about the Deis Workflow, please visit the main project page at https://github.com/teamhephy/workflow.\n\nWe welcome your input! If you have feedback, please [submit an issue][issues]. If you'd like to participate in development, please read the \"Development\" section below and [submit a pull request][prs].\n\n## Description\nA system logger for use in the [Deis Workflow](https://deis.com/workflow/) open source PaaS.\n\nThis Docker image is based on [quay.io/deis/base](https://github.com/teamhephy/docker-base) image. You can see what version we are currently using in the [Dockerfile](rootfs/Dockerfile)\n\nThe new v2 logger implementation has seen a simplification from the last rewrite. While it still uses much of that code it no longer depends on `etcd`. Instead, we will use kubernetes service discovery to determine where logger is running.\n\nWe have also decided to not use `logspout` as the mechanism to get logs from each container to the `logger` component. Now we will use [fluentd](http://fluentd.org) which is a widely supported logging framework with hundreds of plugins. This will allow the end user to configure multiple destinations such as Elastic Search and other Syslog compatible endpoints like [papertrail](http://papertrailapp.com).\n\n## Configuration\nThe following environment variables can be used to configure logger:\n\n| Name | Default Value |\n|------|---------------|\n| STORAGE_ADAPTER | \"redis\" |\n| NUMBER_OF_LINES (per app) | \"1000\" |\n| AGGREGATOR_TYPE | \"nsq\" |\n| DEIS_NSQD_SERVICE_HOST | \"\" |\n| DEIS_NSQD_SERVICE_PORT_TRANSPORT | 4150 |\n| NSQ_TOPIC | logs |\n| NSQ_CHANNEL | consume |\n| NSQ_HANDLER_COUNT | 30 |\n| AGGREGATOR_STOP_TIMEOUT_SEC | 1 |\n| DEIS_LOGGER_REDIS_SERVICE_HOST | \"\" |\n| DEIS_LOGGER_REDIS_SERVICE_PORT | 6379 |\n| DEIS_LOGGER_REDIS_PASSWORD | \"\" |\n| DEIS_LOGGER_REDIS_DB | 0 |\n| DEIS_LOGGER_REDIS_PIPELINE_LENGTH | 50 |\n| DEIS_LOGGER_REDIS_PIPELINE_TIMEOUT_SECONDS | 1 |\n\n## Development\nThe only assumption this project makes about your environment is that you have a working docker host to build the image against.\n\n### Building binary and image\nTo build the binary and image run the following make command:\n\n```console\nDEV_REGISTRY=quay.io IMAGE_PREFIX=myaccount make build\nIMAGE_PREFIX=myaccount make build\nDEV_REGISTRY=myhost:5000 make build\n```\n\n### Pushing the image\nThe makefile assumes that you are pushing the image to a remote repository like quay or dockerhub. So you will need to supply the `REGISTRY` environment variable.\n\n```console\nDEV_REGISTRY=quay.io IMAGE_PREFIX=myaccount make push\nIMAGE_PREFIX=myaccount make push\nDEV_REGISTRY=myhost:5000 make push\n```\n\n### Kubernetes interactions\n* `make install` - Install the recently built docker image into the kubernetes cluster\n* `make upgrade` - Upgrade a currently installed image\n* `make uninstall` - Uninstall logger from a kubernetes cluster\n\n### Architecture Diagram\n```\n                        ┌────────┐\n                        │ Router │                  ┌────────┐\n                        └────────┘                  │ Logger │\n                            │                       └────────┘\n                        Log file                        │\n                            │                           │\n                            ▼                           ▼\n┌────────┐             ┌─────────┐    logs/metrics   ┌─────┐\n│App Logs│──Log File──▶│ fluentd │───────topics─────▶│ NSQ │\n└────────┘             └─────────┘                   └─────┘\n                                                        │\n                                                        │\n┌─────────────┐                                         │\n│ HOST        │                                         ▼\n│  Telegraf   │───┐                                ┌────────┐\n└─────────────┘   │                                │Telegraf│\n                  │                                └────────┘\n┌─────────────┐   │                                    │\n│ HOST        │   │    ┌───────────┐                   │\n│  Telegraf   │───┼───▶│ InfluxDB  │◀────Wire ─────────┘\n└─────────────┘   │    └───────────┘   Protocol\n                  │          ▲\n┌─────────────┐   │          │\n│ HOST        │   │          ▼\n│  Telegraf   │───┘    ┌──────────┐\n└─────────────┘        │ Grafana  │\n                       └──────────┘\n```\n\n[issues]: https://github.com/teamhephy/logger/issues\n[prs]: https://github.com/teamhephy/logger/pulls\n[v2.18]: https://github.com/teamhephy/workflow/releases/tag/v2.18.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteamhephy%2Flogger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fteamhephy%2Flogger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fteamhephy%2Flogger/lists"}