1RedOne/PSLogicMonitor

Some PowerShell Cmdlets to work with LogicMonitor's various APIs

#PSLogicMonitor Some PowerShell Cmdlets to work with LogicMonitor's various APIs

Installation

• Copy the "PSLogicMonitor" folder into your module path. Note: You can find an appropriate directory by running $ENV:PSModulePath.Split(';').
• Run Import-Module PSLogicMonitor from your PowerShell command prompt.

Usage

#####Get Logic Monitor NetApp Aggregate Usage Statistics >Get-LMAggregateUsage -credential $credential | select -First 2 | ft

Name                       Current     Min     Max   Avg StartingUsage Change(%)
----                       -------     ---     ---   --- ------------- ---------
n01_aggr_data_sas_900gb_01 42.6978 42.6244 42.8638 42.75       42.6232 1.0018 % 
n01_aggr_root_sas_900gb_01 33.3809 33.3809 33.3823 33.38       33.3809 0 % 

Defaults to displaying information for ldc-cdot1, but any Hostname can be provided via the -HostName parameter

#####Generate a Logic Monitor Style Report >$HTMLBody = New-LMReport -description "Aggregate Volumes over the last 24 hours" -company 'CompanyNameGoesHere' ` -reportName 'NetApp Volumes over Thresholds' -inputobject (Get-LMAggregateUsage -credential $credential -Verbose -HostName $HostName) -subtitle $HostName

New-SMTPMessage -Body $HtmlBody <other params go here>

Generates a LogicMonitor Style report in HTML, with a Description of $Description, a custom Report Name, and CompanyName

#####Example Report

#####View all devices (with some Stats) in a HostGroup

>Get-LMHostGroup -credential $credential | ? Name -like "KSL*"  | Get-LMHostGroupChildren

alertEnable           : True
createdOn             : 1404416417
groupType             : 0
id                    : 36
parentId              : 35
numOfHosts            : 5
status                : alert-confirmed
description           : 
appliesTo             : 
name                  : Atlanta
signaled              : True
inSDT                 : False
fullPath              : KSL/Atlanta
type                  : HOSTGROUP
inNSP                 : False
effectiveAlertEnabled : True

alertEnable           : True
createdOn             : 1404416633
groupType             : 0
id                    : 37
parentId              : 35
numOfHosts            : 5
status                : alert-confirmed
description           : QTS Suwanee
appliesTo             : 
name                  : BCS
signaled              : True
inSDT                 : False
fullPath              : KSL/BCS
type                  : HOSTGROUP
inNSP                 : False
effectiveAlertEnabled : True

Use this cmdlet to find the ID of a device and see a general list of all of the devices in a hostgroup. You can use the ID value to see particular info on a device.

#How to make new cmdlets

All of these cmdlets were created by writing wrappers around LogicMonitor's REST or RPC APIs.

The full API catalog is available here.

The structure of most wrappers is like the following:

$auth = "c=<companyName>&u=$($credential.UserName)&p=$($credential.GetNetworkCredential().Password)"
$APIEndpoint = "*SomeEndPointHere" #Check the API Index above and put one of the names here
$base = "https://<companyName>.logicmonitor.com/santaba/rpc/$APIEndPoint?&$auth"
$results = invoke-webrequest $base  | select -ExpandProperty Content | ConvertFrom-Json |  select -ExpandProperty Data 
#return $results

Simply find an endpoint, see what params it takes and add them to $base, after $ApiEndpoint? and before &$Auth. Append multiple params using an ampersand(&).