Skip to content

coralogix/coralogix-management-sdk

Repository files navigation

Go Reference

🪵 The Coralogix Management SDK

🌟 Master Docs 🌟

Building

Prerequisites

  • protoc - for compiling protobuf files
  • Make - 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

Apache-2