README
¶
Celestinal
Distributed Log Aggregator
A system that centralizes logs from multiple microservices in a Cloud Native environment.
Requirement:
- Go 1.24.2, Protocol Buffer
- Make (for running commands efficiently)
Main features:
- Distributed log collector (pull/push and agent-based)
- Filter and display logs by namespace, service
- Alert when logs containing critical errors are detected
- Customizable Dashboard with Multiple Charts
Extensions:
- Support tracing with OpenTelemetry
- Provide an API to query logs using SQL-like language
License
Copyright (c) Celestinal Labs. All rights reserved.
Licensed under the Apache 2.0 license.
Logo
Celestinal – photo by Duc-Hung Ho
Licensed under CC BY-SA 4.0
Directories
¶
| Path | Synopsis |
|---|---|
|
api
module
|
|
|
cmd
|
|
|
apiserver
command
Package main provides the entry point for the Celestinal.
|
Package main provides the entry point for the Celestinal. |
|
greeter/v1
command
Package main provides the entry point for the greeter service.
|
Package main provides the entry point for the greeter service. |
|
internal
|
|
|
apiserver
Package apiserver provides the apiserver
|
Package apiserver provides the apiserver |
|
apiserver/handlers/openapi
Package openapi serve apiserver to host swagger ui
|
Package openapi serve apiserver to host swagger ui |
|
apiserver/middleware
Package middleware provide http handler - net/http
|
Package middleware provide http handler - net/http |
|
apiserver/registrar/base
Package registrarbase provides the base service.
|
Package registrarbase provides the base service. |
|
apiserver/registrar/v1
Package registrar provides all service declare.
|
Package registrar provides all service declare. |
|
apiserver/socket
Package socket provides the websocket server for the apiserver
|
Package socket provides the websocket server for the apiserver |
|
apiserver/socket/handlers
Package handlers provides the handlers for the websocket server
|
Package handlers provides the handlers for the websocket server |
|
discovery/v1
Package discovery implements the discovery service
|
Package discovery implements the discovery service |
|
discovery/v1/controllers
Package dcvrctrls provides a service discovery for the celestinal.
|
Package dcvrctrls provides a service discovery for the celestinal. |
|
discovery/v1/domain
Package dcvrdomain implements the discovery business logic
|
Package dcvrdomain implements the discovery business logic |
|
discovery/v1/repos
Package dcvrrepo implements the discovery repository
|
Package dcvrrepo implements the discovery repository |
|
greeter/v1
Package greeter implements the Greeter service server.
|
Package greeter implements the Greeter service server. |
|
greeter/v1/controllers
Package greeterctrls provides the controller for the greeter service.
|
Package greeterctrls provides the controller for the greeter service. |
|
greeter/v1/domain
Package greeterdomain provides the business logic for the greeter service.
|
Package greeterdomain provides the business logic for the greeter service. |
|
greeter/v1/repos
Package greeterrepo provides the database repository for the greeter service.
|
Package greeterrepo provides the database repository for the greeter service. |
|
pkg/eventq
Package eventq provides the event queue for the apiserver app
|
Package eventq provides the event queue for the apiserver app |
|
pkg/version
Package version provides the version of the package.
|
Package version provides the version of the package. |
|
pkg/visitor
Package visitor provides an implementation of the visitor pattern.
|
Package visitor provides an implementation of the visitor pattern. |
|
pkg
|
|
|
cache/mem
Package mem implements a memory cache
|
Package mem implements a memory cache |
|
cache/redis
Package redis provides an implementation of the caching using redis.
|
Package redis provides an implementation of the caching using redis. |
|
color
Package color provides text coloring.
|
Package color provides text coloring. |
|
config
Package config provides the configs for the service.
|
Package config provides the configs for the service. |
|
context
Package context provides a context with a message.
|
Package context provides a context with a message. |
|
copier
Package copier provides functions to copy objects.
|
Package copier provides functions to copy objects. |
|
crypto
Package crypto provides a simple crypto library for the application.
|
Package crypto provides a simple crypto library for the application. |
|
database
Package database provides the database interface.
|
Package database provides the database interface. |
|
database/es
Package es provides an implementation of the database using elasticsearch.
|
Package es provides an implementation of the database using elasticsearch. |
|
database/internal
Package internal not share external module
|
Package internal not share external module |
|
database/kv
Package kv implement key-value storage base on postgresql
|
Package kv implement key-value storage base on postgresql |
|
database/sql
Package sql provides an implementation of the database using PostgreSQL.
|
Package sql provides an implementation of the database using PostgreSQL. |
|
decor
Package decor provides a simple way to decorate functions with context
|
Package decor provides a simple way to decorate functions with context |
|
driver/db
Package db implement database driver
|
Package db implement database driver |
|
driver/db/pg
Package pg implement database driver for PostgreSQL using pgxpool
|
Package pg implement database driver for PostgreSQL using pgxpool |
|
driver/se
Package se implement search engine
|
Package se implement search engine |
|
errors
Package errors provide all type of error in celestinal universal
|
Package errors provide all type of error in celestinal universal |
|
flag
Package flag provide flag variable props
|
Package flag provide flag variable props |
|
grpc/client
Package client provides the grpc client for the greeter service.
|
Package client provides the grpc client for the greeter service. |
|
locale
Package locale provides the locale of the celestinal
|
Package locale provides the locale of the celestinal |
|
logger
Package logger provides the logger for the service.
|
Package logger provides the logger for the service. |
|
logger/internal
Package internal provides the logger for the package.
|
Package internal provides the logger for the package. |
|
names
Package names provide name of all service at celestinal
|
Package names provide name of all service at celestinal |
|
noti
Package noti provide functions log by telegram bot
|
Package noti provide functions log by telegram bot |
|
protobuf
Package protobuf provides utilities for working with protobuf messages.
|
Package protobuf provides utilities for working with protobuf messages. |
|
protobuf/proto
Package proto provides the proto package.
|
Package proto provides the proto package. |
|
protobuf/types
Package types provides the types for the service.
|
Package types provides the types for the service. |
|
striker
Package striker provides the core setting for the application.
|
Package striker provides the core setting for the application. |
|
striker/internal
Package internal provides the internal function for the striker.
|
Package internal provides the internal function for the striker. |
|
striker/skgrpc
Package skgrpc provides a gRPC server for the celestinal.
|
Package skgrpc provides a gRPC server for the celestinal. |
|
striker/skhook
Package skhook provides a way to add hooks to the application lifecycle.
|
Package skhook provides a way to add hooks to the application lifecycle. |
|
striker/skhttp
Package skhttp provides a http server with grpc-gateway support.
|
Package skhttp provides a http server with grpc-gateway support. |
|
striker/sknet
Package sknet provide functions extended of http/net
|
Package sknet provide functions extended of http/net |
|
striker/skutils
Package skutils provides utility functions for striker.
|
Package skutils provides utility functions for striker. |
|
utils
Package utils provides utility functions for the service.
|
Package utils provides utility functions for the service. |
|
uuid
Package uuid provides a simple UUID generator.
|
Package uuid provides a simple UUID generator. |
|
staging
|
|
|
mod/apigateway
module
|
Click to show internal directories.
Click to hide internal directories.