logzio_client

README

Logz.io Terraform client library

Client library for Logz.io API, see below for supported endpoints.

The primary purpose of this library is to act as the API interface for the logz.io Terraform provider. To use it, you'll need to create an API token and provide it to the client library along with your logz.io regional API server address.

The library currently supports the following API endpoints:

• Alerts V2.
• Users.
• Sub-accounts.
• Endpoints.
• Log shipping tokens.
• Drop filters.
• Archive logs.
• Restore logs.
• Authentication groups.
• Kibana Objects.
• S3 Fetcher.
• Grafana dashboards.
• Grafana folders.

Contributing

1. Clone this repo locally.
2. As this package uses Go modules, make sure you are outside of $GOPATH or you have the GO111MODULE=on environment variable set. Then run go get to pull down the dependencies.
3. Use logzio_client.CallLogzioApi when you need to make a Logz.io API call.
4. Use structs to represent the requests/responses body, rather than maps.
5. Sample responses for tests should be under testdata/fixtures.

Run tests

go test -v -race ./...

Changelog

• v1.17.0
  • Add Grafana Folders API.
  • Remove deprecated alerts (v1).
• v1.16.0
  • Add Grafana Dashboards API support.
• v1.15.0
  • Add S3 Fetcher.

Exapnd to check old versions

• v1.14.0
  • alerts_v2 - support new field schedule
• v1.13.1
  • Add retry mechanism for requests.
• v1.13.0
  • Bug fix - sub_accounts: field ReservedDailyGB in requests can be 0.
• v1.12.0
  • Upgrade to Go 1.18.
  • Refactor users, adjust to the recent API fields.
  • Add field UserName to restore initiate request, to match recent API fields.
• v1.11.0
  • Add Kibana Objects.
• v1.10.3
  • Bug fix - sub_accounts: omit maxDailyGb if needed.
• v1.10.2
  • Bug fix - alerts_v2: allow sending with columns without sort.
• v1.10.1
  • Bug fix - custom endpoint: allow empty string for Headers field.
• v1.10.0
  • Add Authentication groups API.
  • Add tests to retrieve archive.
  • Improve tests.
• v1.9.1
  • Bug fix - adjust "not found" message to all resources.
• v1.9.0
  • Add Archive logs API.
  • Add Restore logs API.
• v1.8.0
  • sub_accounts:
    • Add flexible & reservedDailyGB.
    • Breaking changes: refactor resource.
  • endpoints:
    • Breaking changes: refactor resource.
    • Add new endpoint types (OpsGenie, ServiceNow, Microsoft Teams).
• v1.7.0
  • Add drop filters API.
• v1.6.0
  • Add log shipping tokens API compatibility.
• v1.5.3
  • Fix for sub account: return token & account id on Create.
• v1.5.2
  • Fix custom endpoint -empty headers bug.
  • Allow empty array for sharing accounts in sub account.
• v1.5.1
  • Fix alerts_v2 sort bug.
• v1.5
  • Add alerts v2 compatibility.
• v1.3.2
  • fix client custom endpoint headers bug
  • improve tests
• v1.3
  • unnecessary resource updates bug fix.
  • support tags in alerts
• v1.2
  • Add subaccount support

Documentation

Index

• func AddHttpHeaders(apiToken string, req *http.Request)
• func CallLogzioApi(logzioCall LogzioApiCallDetails) ([]byte, error)
• func CheckValidStatus(response *http.Response, status []int) bool
• func Contains(slice []string, s string) bool
• func CreateHttpRequest(req *http.Request) (map[string]interface{}, error)
• func CreateHttpRequestBytesResponse(req *http.Request) ([]byte, error)
• type LogzioApiCallDetails

Functions

func AddHttpHeaders

func AddHttpHeaders(apiToken string, req *http.Request)

func CallLogzioApi

func CallLogzioApi(logzioCall LogzioApiCallDetails) ([]byte, error)

func CheckValidStatus

func CheckValidStatus(response *http.Response, status []int) bool

func Contains

func Contains(slice []string, s string) bool

func CreateHttpRequest

func CreateHttpRequest(req *http.Request) (map[string]interface{}, error)

func CreateHttpRequestBytesResponse

func CreateHttpRequestBytesResponse(req *http.Request) ([]byte, error)

Types

type LogzioApiCallDetails

type LogzioApiCallDetails struct {
	ApiToken     string
	HttpMethod   string
	Url          string
	Body         []byte
	SuccessCodes []int
	NotFoundCode int
	ResourceId   interface{}
	ApiAction    string
	ResourceName string
}