November 23, 2017


Bandwidth

Getting information about bandwidth for a server, including how to get a graph result.

Bandwidth Graph

namespace GetBandwidthGraphNamespace
{
    using System;
    using System.Collections.Generic;

    class GetBandwidthGraph
    {
        /// <summary>
        /// Retrieve a bandwidth graph for a single server.
        /// Retrieve a bandwidth graph for a single server for an arbitrary start and
        /// end date, specifying graph size and other graphing options. We can do this
        /// with two calls to the SoftLayer API.
        /// Counter data such as bandwidth counters and VSI resource use are stored in
        /// a server's metric tracking object. Our first call retrieves that server's
        /// tracking object record. The second call is to the tracking object service
        /// which will generate a PNG image of our bandwidth graph.
        /// </summary>
        /// <manualPages>
        /// Important manual pages:
        /// http://sldn.softlayer.com/reference/services/SoftLayer_Hardware_Server/getObject
        /// http://sldn.softlayer.com/reference/services/SoftLayer_Metric_Tracking_Object/getBandwidthGraph
        /// http://sldn.softlayer.com/reference/datatypes/SoftLayer_Container_Bandwidth_GraphOutputs
        /// </manualPages>
        static void Main(string[] args)
        {
            // Your SoftLayer API username.           
            string username = "set me";

            // Your SoftLayer API key.                    
            string apiKey = "set me";

            // The id number of the server whose graph you wish to retrieve. Call the
            // getHardware() method in the SoftLayer_Account API service to retrieve a list
            // of the servers on your account.
            int serverId = 153851;

            // The date at which you wish to start graphing bandwidth.
            DateTime startDate = DateTime.Now.Subtract(new TimeSpan(20, 0, 0, 0, 0));

            // The date at which you wish to end graphing bandwidth.
            DateTime endDate = DateTime.Now;

            // Whether to get a graph for 'public' or 'private' bandwidth usage.
            string graphType = "public";

            // The height of the text in the bandwidth graph in pixels.
            int fontSize = 8;

            // The width of the graph to retrieve in pixels.
            int graphWidth = 827;
            int graphHeight = 273;
            bool hideTimeZone = true;

            // Creating a connection to the SoftLayer_Account API service and             
            // bind our API username and key to it.           
            authenticate authenticate = new authenticate();
            authenticate.username = username;
            authenticate.apiKey = apiKey;

            SoftLayer_HardwareService hardwareService = new SoftLayer_HardwareService();
            hardwareService.authenticateValue = authenticate;

            SoftLayer_Metric_Tracking_ObjectService metricTrackingObjectService = new SoftLayer_Metric_Tracking_ObjectService();
            metricTrackingObjectService.authenticateValue = authenticate;

            // Setting the init parameter for the hardwareService
            hardwareService.SoftLayer_HardwareInitParametersValue = new SoftLayer_HardwareInitParameters();
            hardwareService.SoftLayer_HardwareInitParametersValue.id = serverId;

            SoftLayer_Metric_Tracking_Object_HardwareServer trackingObject = hardwareService.getMetricTrackingObject();

            // Setting the init parameter for the hardwareService
            metricTrackingObjectService.SoftLayer_Metric_Tracking_ObjectInitParametersValue = new SoftLayer_Metric_Tracking_ObjectInitParameters();
            metricTrackingObjectService.SoftLayer_Metric_Tracking_ObjectInitParametersValue.id = trackingObject.id.GetValueOrDefault();

            try
            {
                // getBandwidthGraph() returns a SoftLayer_Container_Bandwidth_GraphOutputs
                // object. The contents of the bandwidth image is in $image->graphImage.
                // From here you can write it to the file system, display it to a web
                // browser, or run other functions on it.
                SoftLayer_Container_Bandwidth_GraphOutputs image = metricTrackingObjectService.getBandwidthGraph(startDate, endDate, graphType, fontSize, graphWidth, graphHeight, hideTimeZone);
                Console.WriteLine("Image retrieved!");
                //TODO: Base64 Decode the $image->graphImage data, write it to a file.
            }
            catch (Exception e)
            {
                // If there was an error returned from the SoftLayer API then bomb out with the
                // error message.
                Console.WriteLine("Unable to get the bandwidth. " + e.Message);
            }
        }
    }
}

Bandwidth Usage

//-----------------------------------------------------------------------
// <copyright file="GetBandwidthUsage.cs" company="Softlayer">
//     SoftLayer Technologies, Inc.
// </copyright>
// <license>
// http://sldn.softlayer.com/article/License
// </license>
//-----------------------------------------------------------------------

namespace GetBandwidthUsageNamespace
{
    using System;
    using System.Collections.Generic;

    class GetBandwidthUsage
    {
        /// <summary>
        /// Retrieve a bandwidth usage for a list of  servers.
        /// The scripts returns the bandwidth usage from an arbitrary
        /// list of servers, the script makes a simple call to the
        /// Softlayer_Hardware_Server::getObject method using a object mask
        /// in order to get the bandwidth information.
        /// </summary>
        /// <manualPages>
        /// http://sldn.softlayer.com/reference/services/SoftLayer_Hardware_Server/getObject
        /// http://sldn.softlayer.com/reference/datatype/SoftLayer_Hardware_Server/
        /// </manualPages>
        static void Main(string[] args)
        {
            // Your SoftLayer API username.           
            string username = "set me";

            // Your SoftLayer API key.            
            string apiKey = "set me";

            // The list of server that wish to see the bandwidth usage
            int[] servers = { 153851, 166391 };

            // Creating a connection to the SoftLayer_Account API service and             
            // bind our API username and key to it.           
            authenticate authenticate = new authenticate();
            authenticate.username = username;
            authenticate.apiKey = apiKey;

            SoftLayer_HardwareService hardwareService = new SoftLayer_HardwareService();
            hardwareService.authenticateValue = authenticate;

            // Add an object mask to retrieve our hardware' related items such as its
            // host name and currentBillableBandwidthUsage. Object masks
            // can retrieve any information related to your object. See
            // http://sldn.softlayer.com/reference/datatypes/SoftLayer_Hardware_Server
            // for a list of the relational properties you can retrieve along with hardware.
            string objectMask = "mask[hostname,currentBillableBandwidthUsage]";

            hardwareService.SoftLayer_ObjectMaskValue = new SoftLayer_ObjectMask();
            hardwareService.SoftLayer_ObjectMaskValue.mask = objectMask;

            hardwareService.SoftLayer_HardwareInitParametersValue = new SoftLayer_HardwareInitParameters();

            try
            {
                decimal total = 0;
                foreach (var server in servers)
                {
                    hardwareService.SoftLayer_HardwareInitParametersValue.id = server;
                    var bandwidth_data = hardwareService.getObject();
                    Console.WriteLine(bandwidth_data.hostname + ":" + bandwidth_data.currentBillableBandwidthUsage + "GB");
                    total = total + bandwidth_data.currentBillableBandwidthUsage;
                }

                Console.WriteLine("Total :" + total + "GB");
            }
            catch (Exception e)
            {
                Console.WriteLine("unable to bandwidth usage : " + e.Message);
            }
        }
    }
}

Feedback?

If this article contains any error, or leaves any of your questions unanswered, please help us out by opening up a github issue.
Open an issue