{"id":19888371,"url":"https://github.com/bjerkio/google-cloud-logger-slack","last_synced_at":"2026-04-09T23:15:25.929Z","repository":{"id":37824062,"uuid":"401050426","full_name":"bjerkio/google-cloud-logger-slack","owner":"bjerkio","description":"Use Google Cloud Logger to push messages to Slack","archived":false,"fork":false,"pushed_at":"2024-10-24T16:14:21.000Z","size":384,"stargazers_count":7,"open_issues_count":11,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-25T22:36:05.173Z","etag":null,"topics":["app","cloud-functions","cloud-run","fastify","fastify-plugin","gcl","google","handler","logger","logging","notifications","pubsub","pulumi","slack","stackdriver"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bjerkio.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2021-08-29T13:36:48.000Z","updated_at":"2023-08-22T20:50:41.000Z","dependencies_parsed_at":"2023-12-18T13:57:09.170Z","dependency_job_id":"6997cab9-dbba-49d0-8985-6bc83c9495fe","html_url":"https://github.com/bjerkio/google-cloud-logger-slack","commit_stats":null,"previous_names":["bjerkio/gcl-slack"],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bjerkio%2Fgoogle-cloud-logger-slack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bjerkio%2Fgoogle-cloud-logger-slack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bjerkio%2Fgoogle-cloud-logger-slack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bjerkio%2Fgoogle-cloud-logger-slack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bjerkio","download_url":"https://codeload.github.com/bjerkio/google-cloud-logger-slack/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224324497,"owners_count":17292521,"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":["app","cloud-functions","cloud-run","fastify","fastify-plugin","gcl","google","handler","logger","logging","notifications","pubsub","pulumi","slack","stackdriver"],"created_at":"2024-11-12T18:07:02.863Z","updated_at":"2026-04-09T23:15:25.921Z","avatar_url":"https://github.com/bjerkio.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n    \u003cimg src=\"./.github/logo.svg\" alt=\"Logo\" width=\"150px\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ch3 align=\"center\"\u003eSlack for Google Cloud Logging\u003c/h3\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n    Transport messages (and objects) from Google Cloud Logging to Slack\n    \u003cbr /\u003e\n    \u003cbr /\u003e\n    \u003ca href=\"#space_invader--usage\"\u003eQuick Start Guide\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/bjerkio/gcl-slack/issues\"\u003eRequest Feature\u003c/a\u003e\n    ·\n    \u003ca href=\"https://github.com/bjerkio/gcl-slack/issues\"\u003eReport Bug\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/p\u003e\n\n---\n\n[![lifecycle](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://www.tidyverse.org/lifecycle/#experimental)\n[![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](https://github.com/prettier/prettier)\n[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=flat-square)](http://commitizen.github.io/cz-cli/)\n![Release](https://github.com/bjerkio/gcl-slack/workflows/Release/badge.svg)\n\n[![Language grade: JavaScript](https://img.shields.io/lgtm/grade/javascript/g/bjerkio/gcl-slack.svg?logo=lgtm\u0026logoWidth=18)](https://lgtm.com/projects/g/bjerkio/gcl-slack/context:javascript)\n[![codecov](https://codecov.io/gh/bjerkio/gcl-slack/branch/main/graph/badge.svg)](https://codecov.io/gh/bjerkio/gcl-slack)\n[![Maintainability](https://api.codeclimate.com/v1/badges/abaf7c9907eccc452518/maintainability)](https://codeclimate.com/github/bjerkio/gcl-slack/maintainability)\n\n**gcl-slack** consumes logs from Google Cloud Logger and forwards them to Slack.\nUse this library to let your team know something happened in your app, an\nexception is thrown or use the special [slack object] to turn structured logs to\nwell-formatted Slack messages.\n\n[slack object]: #\n[slack blocks]: https://api.slack.com/block-kit\n\n### :zap: \u0026nbsp; Features\n\n- Supports Slack webhook and the Slack API ⚙️\n- [Slack blocks] 📦\n- Sends logs to Slack from all services in your project, including Kubernetes 📬\n\n### :space_invader: \u0026nbsp; Usage\n\nThis project can be deployed using Docker or using Cloud Function (v1).\nWe recommend using Docker, hosted on Google Cloud Run from GitHub Container Registry.\n\n```\ndocker pull ghcr.io/bjerkio/google-cloud-logger-slack:v3.1.0\n```\n\nYou can find examples on how to deploy this project in the [examples] folder, there are both [terraform] and [pulumi] examples\n\n[terraform]: ./examples/terraform\n[docker]: ./examples/docker\n\nIf you want to use the Cloud Function, you can use the following command to\ninstall it to your project:\n\n```shell\n▶ yarn add gcl-slack\n```\n\nYou can deploy however you want, with Pulumi's [Callback\nFunction][pulumi-callback] or with [Firebase CLI][firebase], see the [examples].\n\nYou'll need to configure a [sink] in order to make this work. The basic design\nof this library, is that you'll create a [search query] which you add to a [sink] to\nforward log entries to `gcl-slack`.\n\n[sink]: https://cloud.google.com/logging/docs/export/configure_export_v2\n[search query]: https://cloud.google.com/logging/docs/view/advanced-queries\n[examples]: ./examples\n\n### Turn structured logs to well-formatted Slack messages\n\nThis package solves two issues, a) forwarding information from Cloud Logger to\nSlack and b) offload requests to Slack API / webhooks.\n\nSometimes we want to be notified on Slack when something happens – let's say a\nuser is created or a customer subscribed to your service. Since the _stdout_\nof our application is hooked into Cloud Logging by default, we can output a\nmessage or a JSON object (structured logging). With a _sink_, we can route\nlog entites to this library through Google PubSub.\n\nTo create more than just a simple message, you can use [slack object]s, which is\nthe same as you would send to either the Slack API or webhooks to create\nwell-formatted slack messages.\n\nLet your Kubernetes Pod, Cloud Run or Cloud Functions focus on core business,\nand distribute your logging to Slack with this library!\n\n[pulumi-callback]:\n  https://www.pulumi.com/blog/simple-serverless-programming-with-google-cloud-functions-and-pulumi/\n[firebase]: https://firebase.google.com/docs/functions/get-started\n\n## Contribute \u0026 Disclaimer\n\nWe love to get help 🙏 Read more about how to get started in\n[CONTRIBUTING](CONTRIBUTING.md) 🌳\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbjerkio%2Fgoogle-cloud-logger-slack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbjerkio%2Fgoogle-cloud-logger-slack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbjerkio%2Fgoogle-cloud-logger-slack/lists"}