Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/plurid/delog
Cloud Service for Centralized Logging
https://github.com/plurid/delog
cloud data logging
Last synced: about 7 hours ago
JSON representation
Cloud Service for Centralized Logging
- Host: GitHub
- URL: https://github.com/plurid/delog
- Owner: plurid
- License: other
- Created: 2020-09-26T10:32:20.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2023-07-10T10:47:45.000Z (over 1 year ago)
- Last Synced: 2024-10-09T18:06:25.559Z (29 days ago)
- Topics: cloud, data, logging
- Language: TypeScript
- Homepage: https://plurid.com/delog
- Size: 13.6 MB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
delog
Cloud Service for Centralized Logging
`delog` is a [service](https://delog.plurid.cloud) or self-hosted logger.
`delog` is intended to be:
+ centralized, single logging space for multi-project/multi-package software systems;
+ log-based testing controller;
+ warn/error notifier.
`delog` has clients for:
+ [`CLI`][delog-client-cli];
+ [`NodeJS`][delog-client-javascript];
+ [`Python`][delog-client-python].
The [`delog-server`][delog-server] uses [plurid](https://github.com/plurid/plurid) to explore information as a 3D structure.
analytics
projects
exploration to log source
### Contents
+ [About](#about)
+ [Client](#client)
+ [Support](support)
+ [Configuration](configuration)
+ [Server](#server)
+ [Building](building)
+ [Testing](testing)
+ [Packages](#packages)
+ [Codeophon](#codeophon)
## About
`delog` acts as a central logging service. Once configured with a `token`, the `delog` client can point to the network `endpoint`, passing the `token`.
`delog` can also function as a log-based tester. The `delog` client is set in the testing mode and a `delog` client call will trigger a `tester` in the `delog` endpoint.
## Client
### Support
`delog` has client support for
+ [`CLI`][delog-client-cli]
+ [`NodeJS`][delog-client-javascript]
+ [`Python`][delog-client-python]
+ [`Rust`][delog-client-rust]
### Configuration
The following environment variables can be set
```
// quiets the delog's error reporting
DELOG_QUIET = true | false
// any delog will be checked against this level
DELOG_GROUND_LEVEL = 0-7 | trace-fatal
// format string, default '%TIME %TEXT'
DELOG_FORMAT = string
// delog server endpoint
DELOG_ENDPOINT = string
// delog server token
DELOG_TOKEN = string
// project name
DELOG_PROJECT = string
// space name
DELOG_SPACE = string
// calling details
DELOG_CALL_CONTEXT = true | false
DELOG_REPOSITORY_PROVIDER = string
DELOG_REPOSITORY_NAME = string
DELOG_REPOSITORY_COMMIT = string
DELOG_REPOSITORY_BRANCH = string
DELOG_REPOSITORY_BASEPATH = string
```
## Server
### Building
```
docker build \
-t delog-server \
-f ./configurations/production.dockerfile \
--build-arg PORT=56965 \
--build-arg DELOG_ENDPOINT_GRAPHQL=/ \
--build-arg DELOG_DATABASE_TYPE=mongo \
--build-arg DELOG_LOG_LEVEL=0 \
--build-arg DELOG_QUIET=false \
--build-arg DELOG_CUSTOM_LOGIC_USAGE=false \
--build-arg DELOG_PRIVATE_USAGE=true \
--build-arg DELOG_PRIVATE_OWNER_IDENTONYM=identonym \
--build-arg DELOG_PRIVATE_OWNER_KEY=key \
--build-arg DELOG_PRIVATE_TOKEN=secret-token \
--build-arg DELOG_MONGO_USERNAME=admin \
--build-arg DELOG_MONGO_PASSWORD=1234 \
--build-arg DELOG_MONGO_ADDRESS=localhost:56966 \
--build-arg DELOG_MONGO_CONNECTION_STRING= \
--build-arg DELOG_TEST_MODE=true \
--build-arg DELOG_OPTIMIZATION_BATCH_WRITE_SIZE=1000 \
--build-arg DELOG_OPTIMIZATION_BATCH_WRITE_TIME=2000 \
.
```
Run the container with `--network="host"` if running the database on the same host.
```
docker run \
--network="host" \
-d delog-server
```
Or run on a custom port (`8855`)
```
docker run \
-d -p 8855:56965 \
delog-server
```
### Testing
The `delog server` can use MongoDB as a database. For testing purposes, mongo can run in a docker container.
```
docker pull mongo
```
```
docker run -d --name mongo-delog \
-p 56966:27017 -e MONGO_INITDB_ROOT_USERNAME=admin \
-e MONGO_INITDB_ROOT_PASSWORD=1234 mongo
```
Connect to the mongo instance with
```
mongodb://admin:1234@localhost:56966/?authSource=admin
```
to verify the connection.
## Packages
[@plurid/delog-server][delog-server] • the server application
[delog-server]: https://github.com/plurid/delog/tree/master/packages/delog-server
[@plurid/delog-client-cli][delog-client-cli] • the `Command-Line Interface` client
[delog-client-cli]: https://github.com/plurid/delog/tree/master/packages/delog-client/delog-cli
[@plurid/delog-client-javascript][delog-client-javascript] • the `NodeJS` client
[delog-client-javascript]: https://github.com/plurid/delog/tree/master/packages/delog-client/delog-javascript
[@plurid/delog-client-python][delog-client-python] • the `Python` client
[delog-client-python]: https://github.com/plurid/delog/tree/master/packages/delog-client/delog-python
[@plurid/delog-client-rust][delog-client-rust] • the `Rust` client
[delog-client-rust]: https://github.com/plurid/delog/tree/master/packages/delog-client/delog-rust
## [Codeophon](https://github.com/ly3xqhl8g9/codeophon)
+ licensing: [delicense](https://github.com/ly3xqhl8g9/delicense)
+ versioning: [αver](https://github.com/ly3xqhl8g9/alpha-versioning)