Monitoring

 Linux  processes  using    

Metric  Extensions  in  EM12c  
Date:  Feb  1 st  2014  
Author:  Rob  Zoeteweij    
http://oemgc.wordpress.com  
 
EM12c  come  with  many  Out  of  the  Box  metrics  that  can  be  used  to  monitor  events  
within  your  datacentre  or  application  landscape.  
 
You  might  however  run  into  situations  that  are  not  fully  covered  by  these  Out  of  Box  
Metrics.  I  situation  I  run  into  recently  was  the  demand  to  monitor  the  presence  of  a  
certain  OS  process  on  Linux.  
 
This  article  gives  a  description  of  how  to  create  a  Metric  Extension  for  this.  
 
We  will  create  a  Metric  Extension  called  ME$Process_Status  that  uses  the  following  perl  
script:  
 
#!/usr/local/bin/perl
#
# linuxprocess_collector.pl
#
# NAME
# linuxprocess_collector.pl - Script to get Linux Process state up/down
#
# DESCRIPTION
# This script returns the up/down status of a Linux Process
#
# NOTES
# -
# MODIFIED (MM/DD/YY)
# robztw 09/03/11
#
use File::Temp qw/ tempfile tempdir /;
my $status;

$numArgs = $#ARGV + 1;
if ($numArgs==0)
{print "\nYou must provide the name of the Linux Process!\n";
exit 1;}

foreach $argnum (0 .. $#ARGV) {

if ($argnum > 0) {$WinService = $WinService . " "};

$LinuxProcess = $LinuxProcess . $ARGV[$argnum];

}

my ($fh, $filename) = tempfile();

$syscmd = 'ps -elf | grep "' . $LinuxProcess . '" | grep -v grep | grep -v perl > "' .
$filename . '"';

open($fh, $filename) or die("Can't open $filename");

system($syscmd);

$status=0; # Init
while(my $line = <$fh>) {
print $line;
if($line =~ m/$LinuxProcess/) {$status=1;}
}
close $fh;
print "em_result=$status";
The  creation  of  the  Metric  Extension  goes  as  follows:  
From  the  Enterprise  menu  select  Monitoring  à  Metric  Extensions  
 

 
 
From  the  Metric  Extension  page  click  [Create]  
 

 
 
We  will  name  the  Metric  Extension  ME$Process_Status,  chose  for  Target  Type    ‘Host’,  
give  it  a  Display  Name  and  Description.  We  will  use  the  ‘OS  Command  –  Multiple  
Columns’  Adapter.  
  
We  will  leave  the  Collection  Schedule  as  it  is  and  press  [Next]  
 

 
At  the  Adapter  page  we  use  %perlBin%/perl  as  we  are  using  a  perl  script  to  be  
executed  
 
The  script  is  called  linuxprocess_collector.pl  and  is  uploaded  using  the  [+Add]  icon  
 
Note  that  the  name  of  the  Linux  process  syslogd  is  entered  as  argument  to  the  script.  
 
We  leave  the  delimiter  as  is  and  indicate  that  the  return  value  from  the  script  will  start  
with  ‘em_result=’.  When  you  check  the  perl  script  at  the  beginning  of  this  article  you  
will  notice  that  this  is  the  case.  
 
Press  [Next]  
 

 
 
The  Metric  will  be  using  a  Column  to  communicate  the  Metric  result.  
 
In  this  example  we  create  Column  process_status  that  will  be  used  as  Data  Column  of  
type  Number.    
 
We  select  ‘=’  as  the  Comparison  Operator  for  this  Metric  and  enter  0  as  the  Critical  
Threshold  value,  as  this  is  the  value  that  will  be  returned  by  the  script  in  case  the  
process  is  not  found  running.  
 
Notice  that  we  entered  ‘Process  syslogd  is  down’  as  the  message  text  we  want  to  be  
displayed  when  the  Metric  Extension  is  violated.  
 
Press  [OK]    
 
Press  [Next]  
 
  
 
The  Metric  will  be  using  the  Default  Monitoring  Credentials  
 
Press  [Next]  
 

 
 
In  the  Test  page  we  add  a  Host  where  we  will  test  our  Metric  Extension  
 
Press  [Run  Test]  and  as  you  will  notice  the  test  result  is  value  1  as  the  process  we  are  
checking  syslogd,  is  actually  running.  
 
To  make  sure  the  Metric  Extension  is  functioning  properly  to  do  a  ‘negative’  test  by  
changing  the  argument  to  the  name  of  a  process  we  know  is  not  running.  
 
  
We  change  the  name  of  the  process  to  check  to  syslogdx  (or  any  other  name  of  a  non  
existing  process)  and  proceed  to  the  Test  page  to  rerun  the  test  
 

 
Notice  that  the  Metric  now  returns  value  0  as  the  given  process  is  not  found.  
 
After  resetting  the  name  of  the  process  to  check  to  syslogd  we  precede  to  the  last  page:  
 
  
 
After  being  sure  everything  was  entered  properly  we  press  [Finish]  to  complete  the  
creation  of  the  Metric  Extension  
 

 
To  allow  for  further  testing  we  will  save  the  Metric  as  a  Deployable  Draft  
 

 
Just  select  Save  as  Deployable  Draft  from  the  Action  menu  
 
  
Next  we  want  to  deploy  the  Metric  Extension  to  a  target  by  selecting  Deploy  To  Targets  
from  the  Action  menu  
 

 
By  pressing  [Add]  and  selecting  a  Host  and  pressing  [Submit]  we  schedule  the  
deployment  to  the  Host  
 

 
As  you  notice  the  deployment  of  the  Metric  Extension  is  scheduled  
 
  
Next  we  navigate  to  the  Host  and  from  the  Target  menu  select  All  Metrics  
 

 
At  the  left  side  pane  we  now  see  the  Metric  Extension  being  displayed  
 
We  will  now  stop  the  syslogd  process  to  check  the  Metric  Extension  for  proper  
functioning  
 

 
  
After  just  some  seconds  waiting  the  Metric  shows  that  the  syslogd  process  is  down.