Creating a BDL Monitoring Project

  1. Start Silk Performer and create a BDL monitoring project.
    1. Click the Outline Project button on the Workflow bar. The Workflow - Outline Project dialog box opens.
    2. Enter a name for the project in the Name text box and an optional description in the Description text box.
    3. From the Application Type list, select Monitoring > Bdl Monitor for Performance Explorer.
    4. Click Next.
  2. On the Model Script dialog box, select the Open existing script option button.
  3. Select the script BdlMonitorSample.bdf and click OK. This brings up a pre-configured monitoring script that can be used as a template.
  4. Select Project > Project Attributes to define the project attributes. Each measure exported to Performance Explorer requires a fixed set of project attributes.

    To be viewed with Performance Explorer, each measure requires at least these three project attributes:

    • Name: Name to be shown in Performance Explorer
    • Type: An average value or a cumulative value.
    • Enabled: Reserved. Always set to true.
  5. Review the sample monitor script

    As specified in the project attributes, the project exports two measures that can be viewed in Performance Explorer in real-time.

    Look for MonitorInc and MonitorIncFloat in the TMon transaction. This is where the last snapshot is handed over to Performance Explorer.

    use "bdlMonitor.bdh"
    
    const
      nMeasure1 := 1;
      nMeasure2 := 2;
    
    dclrand
      rRand   : RndExpN  (1..10000: 100.000000);
      rRandf  : RndExpF  (5.500000);
    
    var
      fScale : float;
     
    dcluser  
      user
        VMon
      transactions
        TInit           : begin;  
        TMon            : 1;
        TEnd            : end;    
                                  
    dcltrans
      transaction TInit
      begin
        fScale := AttributeGetDouble("scale");   
      end TInit;
    
      transaction TMon 
      var
        n : number;
        f : float;
      begin
        n := rRand;
        MonitorInc(1, n);
      
        f := rRandf;
        f := f * fScale;
        MonitorIncFloat(2, f);
      end TMon;
  6. Edit the .conf file. The sample .conf file is available in the Project tree under the Data Files node. Double-click the .conf file to open it and change the value of the Type entry. This indicates where in the Performance Explorer hierarchy the project is to be located. For example, use <Type>Monitoring\Sample Project</Type> to locate the monitoring project in Performance Explorer under Monitor > Add DataSource > Predefined data sources at the location Monitoring\Sample Project.
  7. Export the project to a single ZIP archive. Choose File > Export Project. Check the Zip to single archive file check box. For the Export location, set C:\Program Files\Silk\Silk Performer <version>\Monitors\BdlMonitorSample.sep.
    Note: Save the file with an .sep extension.
  8. Start a Realtime BDL Monitoring Project
    1. Start Performance Explorer. On the Monitoring tab, in the Monitor group, click System. Select the Select from predefined Data Sources option button and click Next.
    2. Select the newly created monitoring project (for example, Monitoring > Sample Project) and click Next.
    3. Enter the name of the host that is to be monitored (select localhost or the host recommended by Performance Explorer and click Next). This brings up a dialog on which project attributes can be modified (only one attribute can be modified in this instance).
    4. Enter a value greater than 0. This value will be used in the monitoring project. See the sample script for details.
    5. Click OK. This brings up a choice of measures specified in the BDL monitoring project.
    6. Select both measures and click Finish. This launches the monitoring project. The values can now be seen in real-time using a monitoring graph.