CloudWatch-IRIS


Follow
0
Star
1
Details
Version history
Issues

What's new in this version

Initial Release

Configuring AWS CloudWatch with InterSystems IRIS

CloudWatch-IRIS

AWS CloudWatch monitoring for InterSystems IRIS

You can easily publish InterSystems IRIS metrics and Logs to AWS CloudWatch. With metrics and logs in place you can integrate IRIS data into dashboards, alerts etc.

Metrics are based on data, returned by IRIS REST Monitor API https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=GCM_rest messages.log is used as a log data source https://docs.intersystems.com/irislatest/csp/docbook/DocBook.UI.Page.cls?KEY=ITECHREF_cconsole_log

CloudWatch Dashboard with IRIS logs, metrics and EC2 host-level data:

CloudWatch Dashboard

IRIS messages.log analyzed with Log Insights

CloudWatch Log Insights for messages.log

Installation

Installation assumes the following:

  • You are running Amazon Linux 2 instance on EC2
  • IRIS version is 2019.4 or later (earlier version does not have MONITOR)
  • IRIS is installed in /iris/sys folder
  • EC2 instance role allows publishing CloudWatch logs and metrics (you can use CloudWatchAgentServerPolicy for that)

For platforms other than Amazon Linux 2 you can follow this guide to install CloudWatch agent: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/QuickStartEC2Instance.html

For details on creating Ec2 Instance Role with CloudWatch access see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/create-iam-roles-for-cloudwatch-agent-commandline.html

Install Pyton 3, awslogs client and reqired libraries:

sudo yum install -y python3
sudo yum install -y awslogs
sudo pip3 install requests boto3

Download from repository and copy files to designated folders:

wget https://raw.githubusercontent.com/antonum/CloudWatch-IRIS/master/iris-monitor-cloudwatch.py
wget https://raw.githubusercontent.com/antonum/CloudWatch-IRIS/master/intersystems-iris.conf
sudo cp iris-monitor-cloudwatch.py /iris/sys/
sudo cp intersystems-iris.conf /etc/awslogs/config/

Start monitoring and awslog collection:

sudo systemctl start awslogsd
sudo systemctl enable awslogsd.service
sudo su
echo "*  *  *  *  * root  python3 /iris/sys/iris-monitor-cloudwatch.py" >> /etc/crontab

Category
Interoperability
Works with
InterSystems IRISInterSystems IRIS for Health
Tags
Info
Version
1.0.0
Last updated
2020-04-02
Repository
Open
Documentation
Open
License
Link