2 unstable releases
0.2.0 | Aug 19, 2024 |
---|---|
0.1.0 | Aug 15, 2024 |
#235 in Debugging
180KB
3.5K
SLoC
🪵 The Coralogix Management SDK
🌟 Master Docs 🌟
Building
Prerequisites
protoc
- for compiling protobuf filesMake
- for Go development
The file proto-toolchain-versions.txt
contains the versions of the protobuf tools that you need to contribute to the SDK: please make sure these are the versions that you have on your system.
Please refer to the individual languages on how to build the SDKs
Configuration
The SDK can be configured using environment variables:
CORALOGIX_TEAM_API_KEY
: The API key that is used for all team-level interactions. Note that it has to have appropriate permissions. Read the docs for more information.CORALOGIX_USER_API_KEY
: The API key that is used for all user-level interactions. Note that it has to have appropriate permissions. Read the docs for more information.CORALGOIX_REGION
: The region/cluster to connect to as a shorthand (EU2, AP1, etc. read more here).
Furthermore, if you want to run the examples locally, you're going to to have set the following environment variables:
AWS_REGION
: The aws region that you wanna use in the examples, eg.eu-north-1
.METRICS_BUCKET
: The name of the S3 bucket that you want to use for the archive-metrics example.LOGS_BUCKET
: The name of the S3 bucket that you want to use for the archive-logs example.
Please note that for all examples these variables have to be set to a valid cluster and API key.
Examples
You'll find some example use-cases of the SDK in the examples
folder under each programming language. Please, keep in mind that aaa
stands for "authentication, authorization and accounting", so you should look there if you're looking for an example related to one of those areas.
Protobuf
The proto/
directory contains all protobuf files for generating your own SDK if necessary. They are also the basis for all SDKs in this repository.
Contributing
We welcome contributions! Be it docs, code, or even just opening an issue will help improve this SDK for everyone. To learn more check out CONTRIBUTING.md.
To add code to this repository you are required to sign our Contributor License Agreement.
License
lib.rs
:
The Rust SDK for Coralogix APIs.
Dependencies
~18–31MB
~562K SLoC