AdvancedExercise.md

Advanced Exercise

Polling the data

Create a data source to poll the status of a networking device

1. Open the Data Sources module: In DataMiner Cube, click Apps in the sidebar to the left and select Data Sources,
2. Click Create Data Source.
3. Configure the Data source name field with an identifiable name (e.g. Router Status) and ensure the Type is set to Python.
4. In the code editor window, create a Python script that
   1. fetches the response from the URL https://routersimulation.azurewebsites.net/RouterStatus
   2. pushes data to DataMiner with identifier = Lab router and type = Router Status;

import requests

def main():
    # Use this boiler plate code but fill in the URL, type and identifier

    # Define header parameters for the request to the local API
    header_params = {
        # Fill in the identifier
        "identifier": "" , 
        # Fill in the type
        "type": "", 
    }
    
    # Create a session object to manage and persist settings across requests
    session = requests.Session()

    # Send a GET request to the status API to get the current status in JSON format
    # Fill in URL
    status = session.get("url")
    
    
    # Send a PUT request to the local Data API with the status data
    # Include the header parameters for additional context
    session.put("http://localhost:34567/api/data/parameters", json=status.json(), headers=header_params) 

# Execute the main function when the script is run
if __name__ == "__main__":
    main()

To verify the results:

• Locate the newly created element in the Surveyor.
• Verify that the element is being populated with data.

Configure units and precision

Create a data source to configure the unis and decimal precision for some parameters in the element Lab router.

1. Create a data source.

2. Configure the Data source name field with an identifiable name (e.g. "Units & decimal precision") and ensure the Type is set to Python.

   Parameter Name	Decimal precision	Units
   cpuUtilization	2	%
   Temperature	1	deg C
   memoryUsage		%
   table Fans, column Speed		RPM
   table Interfaces, column Speed		Mbps

3. Create Python script that

   1. pushes the decimal and unit configuration
   2. uses the type = Router Status.

import requests

def main():
    # Use this boiler plate code but fill in the type, decimal precision and units

    # Define header parameters for the request to the local API
    header_params = {
        # Fill in the type
        "type": "",
    }
    
    # Create a session object to manage and persist settings across requests
    session = requests.Session()

    # Configuration to change units and decimal precision
    config = {
        "decimals": {
            # Fill in the decimal precision
            "Cpuutilization": 0,
            "Temperature": 0
        },
        "units": {           
            # Fill in the units
            "Cpuutilization": "",
            "Temperature": "",
            "Memoryusage": "",
            "Fans": [
                {
                    "Speed": ""
                }
            ],
            "Interfaces": [
                {
                    "Speed": ""
                }
            ]
        }
    }

   
    # Send a PUT request to the local Data API with the status data
    # Include the header parameters for additional context
    session.put("http://localhost:34567/api/config", json=config, headers=header_params) 

# Execute the main function when the script is run
if __name__ == "__main__":
    main()

Note

Earn 25 DevOps points by emailing screenshots of the Parameters page and the Interface page of the element card to support.data-acquisition@skyline.be.