QuickStartGuide.md

Moneo Quick Start Guide

Description

This guide will walk you through the simple steps of setting up Moneo. This guide assume that all dependencies and requirements have been meant.

Steps

1. Clone Moneo from Github and install ansible.

   # get the code
   git clone https://github.com/Azure/Moneo.git
   cd Moneo
   
   # install dependencies
   python3 -m pip install ansible

   Note: If you are using an Azure Ubuntu HPC-AI VM image you can find the Moneo in this path: /opt/azurehpc/tools/Moneo

2. Next create a host.ini config file.

   [master]
   192.168.0.100
   
   [worker]
   192.168.0.100
   192.168.0.101
   192.168.0.110
   
   [all:vars]
   ansible_user=username
   ansible_ssh_private_key_file=/path/to/key
   ansible_ssh_common_args='-o StrictHostKeyChecking=no'

   Note: The master node can also be work node as well. The master node will have the Grafana and Prometheus docker containers deployed to it.

   Note: If you have configured passwordless SSH already, [all:vars] section can be skipped.

   Note: The master node must be able to ssh into itself

3. Now deploy Moneo

   • using Moneo cli:

   python3 moneo.py --deploy -c host.ini full

   note: see usage section of the README doc for more details on Moneo CLI

   • manual deployment

   ansible-playbook -i host.ini src/ansible/deploy.yaml

4. Log into the portal by navigating to http://master-ip-or-domain:3000 and inputting your credentials

   Note: By default username/password are set to "azure". This can be changed here "src/master/grafana/grafana.env"

5. Navigating Moneo Grafana Portal

   • The current view is labeled in the top left corner:

     

   • VM instance and GPU can be selected from the drop down menus in the top left corner:

     

   • Various actions such as dashboard selection or data source configuration can be achieved using the left screen menu:

     

   • Metric groups are collapsable: