lm-data-sdk-go

README

LogicMonitor Golang Data SDK

LogicMonitor Golang Data SDK is suitable for ingesting the metrics and logs into the LogicMonitor Platform.

Overview

LogicMonitor's Push Metrics feature allows you to send metrics directly to the LogicMonitor platform via a dedicated API, removing the need to route the data through a LogicMonitor Collector. Once ingested, these metrics are presented alongside all other metrics gathered via LogicMonitor, providing a single pane of glass for metric monitoring and alerting.

Similarly, If a log integration isn’t available or you have custom logs that you want to analyze, you can send the logs directly to your LogicMonitor account via the logs ingestion API.

Quick Start Notes:

Set Configurations

While using LMv1 authentication set LM_ACCESS_ID and LM_ACCESS_KEY properties. In Case of BearerToken Authentication set LM_BEARER_TOKEN property. Company's name or Account name must be passed to LM_ACCOUNT property. All properties can be set using environment variable.

Environment variable	Description
LM_ACCOUNT	Account name (Company Name) is your organization name
LM_ACCESS_ID	Access id while using LMv1 authentication.
LM_ACCESS_KEY	Access key while using LMv1 authentication.
LM_BEARER_TOKEN	BearerToken while using Bearer authentication.

Metrics Ingestion:

For metrics ingestion, user must create a object of ResourceInput, DataSourceInput, InstanceInput and DataPointInput using github.com/logicmonitor/lm-data-sdk-go/model. Create NewLMMetricIngest by passing batch as true (if batching to be enabled) and interval (value in seconds) as parameters. Then call SendMetrics by passing all the attributes as input parameters.

// fill the values
rInput := model.ResourceInput{
	ResourceName: "jyoti-1006-aci_OTEL_29591",
	ResourceID: map[string]string{"system.displayname": "jyoti-1006-aci_OTEL_29591"},
}

dsInput := model.DatasourceInput{
	DataSourceName:        "TestGoSDK",
	DataSourceDisplayName: "TestGoSDK",
	DataSourceGroup:       "TestSDK",
}

insInput := model.InstanceInput{
	InstanceName:       "DataSDK",
	InstanceProperties: map[string]string{"test": "datasdk"},
}

dpInput := model.DataPointInput{
	DataPointName:            "cpuusage",
	DataPointType:            "COUNTER",
	DataPointAggregationType: "SUM",
	Value:                    map[string]string{fmt.Sprintf("%d", time.Now().Unix()): "124"},
}

lmMetric := metrics.NewLMMetricIngest(true, 10)
lmMetric.SendMetrics(rInput, dsInput, insInput, dpInput)

Logs Ingestion

Create NewLMLogIngest by passing batch as true (if batching to be enabled) and interval value as parameters. Then call SendLogs by passing 'log message', 'resourceID' and 'metadata' as input parameters.

lmLog := logs.NewLMLogIngest(false, 10)
lmLog.SendLogs(logstr, map[string]string{"system.displayname": "device-name-test"}, map[string]string{"testkey": "testvalue"})

Read the Library Documentation to use Metrics/Logs ingestion API.

Copyright, 2022, LogicMonitor, Inc.

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at https://mozilla.org/MPL/2.0/.