Welcome to cloki, an open-source logger designed to bridge Cloudflare Workers with Grafana Cloud's Loki seamlessly and efficiently. Targeted at individual developers, cloki aims to reduce maintenance costs while offering a straightforward logging solution. With minimal configuration and the sole use of the fetch API, cloki is an easy-to-implement tool for effective logging.
- Easy Integration: Connect Cloudflare Workers with Grafana Cloud's Loki effortlessly.
- Minimal Configuration: Get started with just a few simple settings.
- Zero Dependencies: cloki has zero dependencies, making it easy to maintain.
- Fetch API Usage: cloki uses the Fetch API, so it can be used in any environment like edge runtime.
$ npm i @miketako3/cloki
- Create a Grafana Cloud account from here.
- Access https://grafana.com/orgs/${YOUR_ORG_NAME}
- Click Detail.
- You got the required information.
import {Cloki} from '@miketako3/cloki'
const logger = getLokiLogger({
lokiHost: "Host URL (e.g. logs-xxx-yyy.grafana.net)",
lokiUser: "User (e.g. 123456)",
lokiToken: "Generated API Token"
});
await logger.info({message: "Hello World!"});
await logger.error({message: "Hello World!", error: error});
// with addional labels
await logger.info({message: "Hello World!"}, {foo: "bar"});
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (git checkout -b feature/AmazingFeature)
- Commit your Changes (git commit -m 'Add some AmazingFeature')
- Push to the Branch (git push origin feature/AmazingFeature)
- Open a Pull Request
Distributed under the MIT License. See LICENSE for more information.
miketako3 (Kaito Hiruta) - contact@miketako.xyz
Project Link: https://github.com/miketako3/cloki