See how cloud templates provide default diagnostic monitoring setup.

Transcription

1 Lab Exercise Diagnostics Even the best applications run into difficulties. Tracking down issues and solving problems is never easy, but without diagnostic and log information, it is almost impossible. In this lab, you explore how to make entries in trace logs. You also explore how to capture diagnostic information and move that data to Windows Azure Storage. Since you do not always have direct access to the machines on which your cloud application runs, you need to have the Windows Azure Diagnostic Service move the data to Windows Azure Storage for you. This can be accomplished on a scheduled, periodic basis or it can be performed ondemand. You try both transfer types in this lab. Specifically, in this lab you will: See how cloud templates provide default diagnostic monitoring setup. Add trace statements to cloud code. Learn how to schedule diagnostic data to be transferred to Windows Azure Storage. Learn how to perform an on-demand transfer of diagnostic data to storage. Lab solution folder: D\WindowsAzure\LabA-DiagnosticsLab\L\End D is your installation drive and labs root directory example: C:\labfiles. Ask your instructor for the location for your class setup. L is your language of choice either C# or VB (for Visual Basic). 1

2 Scenario The WhereAreYou cloud-based geography quiz game is ready to go. You have a working game and the administrative tools to help keep it up and running with new questions as needed. Before publishing the final version to the cloud, you want to make sure your application tracks and supplies you with logging and diagnostic information to help you understand the health and welfare of the application. First, add some trace statements to your application to log what the application is doing at critical application junctures. Next, you need to configure the diagnostic agent to capture logs and other critical diagnostic data you think you might need to monitor the status of your application, and to fix issues when the application is not operating correctly. Lastly, you need to have the Diagnostic Monitor service move the diagnostic data collected to Windows Azure Storage. In this lab, you add a little trace code and configure your application to collect a few performance statistics apart from the logs automatically collected by default. You also use the Diagnostic Service in Windows Azure to move the collected data to Windows Azure Storage. In a real world application, adding the appropriate trace statements and figuring out what data you need for health status and issue determination could be a larger undertaking. Step 1: Start VS and Open the WhereAreYou solution. If you already have VS open and were able to complete the last lab, you can skip this step (go to step 2). 1.1 Unless already open, start VS Remember, you must run VS as an administrator. 1.2 If you completed the last lab, open the WhereAreYou solution Open the solution file for WhereAreYou. In VS, select File from the menu bar. In the resulting menu, select Open > Project/Solution. 2

3 1.2.2 In the Open Project window, open the WhereAreYou.sln file. Assuming you used the default location, you should find the project solution in D\Projects Now go to step 2 to continue the lab. 3

4 1.3 If you did not complete the last lab, copy and use the solution to the last lab before starting this lab Copy the contents of D\WindowsAzure\Lab11-SQLAzureIntroLab\L\End to your D\Projects folder (or wherever you created your projects folder) When you paste, confirm you want existing files replaced in the directory. Note: This will destroy your existing files. If you wish to keep your existing work from the last lab, copy your project folder to a different directory before replacing its contents. 4

5 1.3.3 Open the solution file for WhereAreYou. On the VS menu bar, select File. In VS, select File from the menu bar. In the resulting menu, select Open > Project/Solution In the Open Project window, open the WhereAreYou.sln file. 5

6 Step 2: Explore Default Diagnostic Service Configuration By default, when you create a Web or worker role project using the Windows Azure templates, the diagnostic service is already partially configured. 2.1 See where the Trace Listener is established Open the Web.config and/or app.config for any Web role or worker role project by double clicking on the file in the Solution Explorer. 6

7 2.1.2 In this file, find the <system.diagnostics> entry as shown below (both Web.config and app.config have the element, although it should be considerably easier to find in the app.config file as it will likely be the only entry). The entry establishes the trace listener for the diagnostic monitor. <system.diagnostics> <trace> <listeners> <add type= "Microsoft.WindowsAzure.Diagnostics.DiagnosticMonitorTraceListener, Microsoft.WindowsAzure.Diagnostics, Version= , Culture=neutral, PublicKeyToken=31bf3856ad364e35" name="azurediagnostics"> <filter type="" /> </add> </listeners> </trace> </system.diagnostics> Double click on any of the projects listed under Roles in the WhereAreYou Cloud project to open the project s configuration GUI editor. 7

8 2.1.4 On the Configuration tab, note that each role as diagnostics enabled by default. Also note that diagnostic results are to be stored in development storage by default Switch to the Settings Tab Notice that the Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString configuration setting has been set up to use development storage in each project by default. Modify the setting when it is time to move the project into the Windows Azure cloud to use the Azure Storage account of your choice. 8

9 Step 3: See DiagnosticsAgent Running The DiagnosticsAgent process collects diagnostic data to a local buffer. 3.1 Start debugging the application. As you did in the previous labs, start the project in the Compute Emulator by pressing F Open a Windows Task Manager and find DiagnosticsAgent processes To start the Task Manager, right click on the Toolbar at the bottom of the Windows screen and select Start Task Manager. 9

10 3.2.2 Locate the DiagnosticsAgent.exe processes that are running. There should be one process running for each role instance running. In the example below, one instance of each of the roles (WhereAreYouWebRole, AdminWebRole, and StoreContestantWorkerRole) are running, and therefore there are 3 instances of DiagnosticsAgent.exe running. 3.3 Stop debugging to begin the next steps of the lab. 10

11 Step 4: Add Trace Statements to Worker Role 4.1 Open the WorkerRole class and explore existing trace statements Open WorkerRole.cs (or WorkerRole.vb for VB) in the StoreContestantWorkerRole project by double clicking on the file in the Solution Explorer Notice, by default, the Run( ) method of a worker role already contains two trace statements. One statement logs the fact that the worker role has been started and the other statement logs entering the loops of the infinite loop. public override void Run() Trace.WriteLine("StoreContestantWorkerRole entry point called", "Information"); while (true) Thread.Sleep(10000); Trace.WriteLine("Working", "Information"); this.processcontestantresults(); 11

12 4.2 Add code to start the diagnostic monitor. In the OnStart( ) method, call to start the DiagnosticMonitor. Use the diagnostics connection string defined in the role s settings to start the monitoring. Note: If you do not wish to add this code manually, you can copy and paste the code from the file available at D\WindowsAzure\LabA-DiagnosticsLab\L\Begin. For C# public override bool OnStart() // Set the maximum number of concurrent connections ServicePointManager.DefaultConnectionLimit = 12; DiagnosticMonitor.Start( "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString"); // For information on handling configuration changes // see the MSDN topic at // SetupConfigurationPublisher(); return base.onstart(); For VB Public Overrides Function OnStart() As Boolean ' Set the maximum number of concurrent connections ServicePointManager.DefaultConnectionLimit = 12 DiagnosticMonitor.Start( _ "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString") ' For information on handling configuration changes ' see the MSDN topic at ' Me.SetupConfigurationPublisher() Return MyBase.OnStart() End Function 12

13 4.3 Add trace statements. In order to better explore the diagnostic service, add some trace statements to methods of the worker role in the StoreContestantWorkerRole project Add trace calls (Trace.WriteLine or Trace.TraceInformation) to methods in the Method to add a Trace OnStart CreateAndSaveContestant ProcessContestantResults For C# For VB worker role to provide information and visibility into what the worker role is doing. You can add them anywhere, but here is a list of recommended places to log. Reason Log that the worker role has started. Log that a new contestant record has been created and saved (possibly even log the contestant information). Log the number of messages found in the queue that are about to be processed As an example, here is the CreateAndSaveContestant method with added Trace statements. private void CreateAndSaveContestant(string messagedata) Contestant contestant = new Contestant(messageData); ContestantDataSource.Add(contestant); Trace.TraceInformation("Contestant record saved: " + contestant.tostring()); Private Sub CreateAndSaveContestant(ByVal messagedata As String) Dim contestant As New Contestant(messageData) ContestantDataSource.Add(contestant) Trace.TraceInformation("Contestant record saved: " + contestant.tostring) End Sub Save the file after adding your trace statements (Control-S). 13

14 Step 5: Test the Worker Role and Examine the Trace Log 5.1 Start debugging the application. As you did in the previous labs, start the project in the Computer Emulator by pressing F See the worker role running via the Compute Emulator UI Right click on the Compute Emulator UI icon in the System Tray Select Show Compute Emulator UI from the resulting menu When the Compute Emulator window opens, note the three roles (2 Web roles and one worker role) you now have running. 14

15 5.2.4 Click on the #0 instance of the StoreContestantWorkerRole. This causes the trace log for the role to enlarge so that you can read it. In the trace log, find the output for logging you added to your code. You may have to play the WhereAreYou game a couple of times to see all the log entries show up in the trace logs. Step 6: Configure the Diagnostic Monitor By default, the diagnostic service collects Windows Azure Trace Logs, IIS Logs (for Web roles) and Windows Azure Diagnostic Infrastructure Logs. As you learned, the service can collect even more data. For example, you can collect Windows Event logs or IIS Failed Request logs. For example sake, say that your project manager came to you and wants to present information on how well things are going on the WhereAreYou game site. You decide to use the diagnostic service to collect some performance statistics. In this case, you decide to capture the total number of requests (ASP.NET requests) of the site and the average time it takes to respond to each request. In addition to telling Windows Azure what additional data you want collected, you must also tell the diagnostic service that you would like the data put in Windows Azure Storage. Configure the service to offload the performance counter data to Windows Azure Storage every couple of minutes. 15

16 6.1 Add code to collect performance statistics Open WebRole class of the WhereAreYouWebRole by double clicking on the file in the Solution Explorer. 16

17 6.1.2 Add code to the top of the OnStart( ) method to create a new DiagnosticMonitorConfiguration object. Use the configuration object to designate to the diagnostic service that you want two new performance counters collected. Namely, you want to collect ASP.NET requests (\ASP.NET Applications( Total )\Requests Total ) and average time per ASP.NET request (\ASP.NET Applications( Total )\Requests/Sec). For C# For VB Note: If you do not wish to add this code manually, you can copy and paste the code from the file available at D\WindowsAzure\LabA-DiagnosticsLab\L\Begin. DiagnosticMonitorConfiguration diagconfig = DiagnosticMonitor.GetDefaultInitialConfiguration(); PerformanceCounterConfiguration totalrequestsconfig = new PerformanceCounterConfiguration(); totalrequestsconfig.counterspecifier Applications( Total )\Requests Total"; totalrequestsconfig.samplerate = TimeSpan.FromSeconds(30.0); diagconfig.performancecounters.datasources.add(totalrequestsconfig); PerformanceCounterConfiguration requesttimeconfig = new PerformanceCounterConfiguration(); requesttimeconfig.counterspecifier Applications( Total )\Requests/Sec"; requesttimeconfig.samplerate = TimeSpan.FromSeconds(30.0); diagconfig.performancecounters.datasources.add(requesttimeconfig); Dim diagconfig As DiagnosticMonitorConfiguration = DiagnosticMonitor.GetDefaultInitialConfiguration() Dim totalrequestsconfig As New PerformanceCounterConfiguration() totalrequestsconfig.counterspecifier = "\ASP.NET Applications( Total )\Requests Total" totalrequestsconfig.samplerate = TimeSpan.FromSeconds(30.0) diagconfig.performancecounters.datasources.add(totalrequestsconfig) Dim requesttimeconfig As New PerformanceCounterConfiguration() requesttimeconfig.counterspecifier = "\ASP.NET Applications( Total )\Requests/Sec" requesttimeconfig.samplerate = TimeSpan.FromSeconds(30.0) diagconfig.performancecounters.datasources.add(requesttimeconfig) In this case, you are requesting the two performance counters be collected every 30 seconds. 17

18 For C# For VB Right below the code you just added, inform the diagnostic service that you would like the performance data moved to Windows Azure Storage every two minutes. diagconfig.performancecounters.scheduledtransferperiod = TimeSpan.FromMinutes(2.0); For C# For VB diagconfig.performancecounters.scheduledtransferperiod = TimeSpan.FromMinutes(2.0) Add the call to start the diagnostic monitor. Pass the configuration object (now holding the perf counters and scheduled transfer settings) as a parameter into the DiagnosticMonitor.Start( ) method call located in the OnStart( ) method. DiagnosticMonitor.Start( "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString", diagconfig); DiagnosticMonitor.Start("Microsoft.WindowsAzure.Plugins.Diagnostics.Co nnectionstring", diagconfig) 6.2 Save the WebRole class (Control-s). Step 7: Test Peformance Counter Capture 7.1 Start debugging the application. As you did in the previous labs, start the project in the Compute Emulator by pressing F Play the WhereAreYou game a few times in order to build up some hits on the ASP.NET site. Remember, you set the schedule transfer of performance data to occur every two minutes. So you need to take some time playing before the first transfer occurs. 18

19 Step 8: Use Windows Azure MMC to Explore the Storage Emulator After two minutes, explore the Storage Emulator. You should find a new table (WADPerformanceCountersTable) has been automatically created for you. 8.1 Start and connect Windows Azure MMC to the Storage Emulator Using Windows Explorer, browse to the location of your Windows Azure MMC installation (probably C:\WindowsAzureMMC\release). Locate the WindowsAzureMmc.msc file in this directory and double click on it to start the tool After the tool starts and the WindowsAzureMmc window displays, click on the little arrow next to the Windows Azure Management option in the left-hand pane to expand it. 19

20 8.1.3 This displays Service Management, Storage Explorer and Operations queue items Right click on the Storage Explorer item and select Connect Local from the resulting menu to have the console connect to your local Storage Emulator As a result of this action, the Storage Explorer item should change to devstoreaccount1 and if you expand the item, you should see BLOB Containers, Queues, and Tables as child items. 20

21 8.2 Explore the tables In the Windows Azure Mmc window, click on the Tables item under devstoreaccount1. A Tables pane appears listing the tables in your Storage Emulator. Find the WADPerformanceCountersTable listed in the panel Double click on the WADPerformanceCountersTable in the panel. A list of records displays in the bottom panel Explore the contents of the table. You should find several records for the total number of requests and total requests per second. Recall that the configuration indicated the sampling rate was for 30 seconds. So each record represents a 30- second span of performance measuring. 21

22 8.3 Stop debugging in order to continue with the next step in the lab. Step 9: Make an On-Demand request for Worker Role Data You added trace statements to the StoreContestantWorkerRole in step 6 above. Currently, however, the data is collected by the diagnostics agent and stored into a local buffer. However, the data is never moved to Windows Azure Storage. Add code to the AdminWebRole project to request the StoreContestantWorkerRole diagnostic data be moved to Windows Azure Storage in an on-demand fashion. 9.1 Configure the Web role to use a new queue. Add a new queue name to be used by the diagnostic manager for on-demand transfer completion Double click on the AdminWebRole listed under Roles in the WhereAreYou Cloud project (see below) to open the project s configuration GUI editor In the resulting GUI editor, select the Settings tab. On this tab, push the Add Setting button. 22

23 9.1.3 In the line that opens: add OnDemandTransferCompleteQueue as the name of your new configuration setting, set its type to String, and set the value to ondemandcompletedqueue Save the configuration settings for AdminWebRole (Control-S). 9.2 Add a button to the Admin Console to trigger the on-demand request Open Default.aspx in the AdminWebRole project by double clicking on the file in the Solution Explorer. 23

24 9.2.2 Add a button at the bottom of the screen (right after the table for question data entry). This button triggers the diagnostic manager to start the transfer of data from a local buffer to Windows Azure Storage. Note: If you do not wish to add this code manually, you can copy and paste the code from the Default.aspx file available at D\WindowsAzure\LabA-DiagnosticsLab\L\Begin.... </table> </p> <p> <asp:button ID="StartOnDemandTransferButton" runat="server" Text="Start Worker Role Data Transfer" OnClick="StartOnDemandTransferButton_Click" /> </p> </asp:content> Right after the button, add a script manager and timer to trigger the end of the transfer. Note: Recall that an on-demand transfer is an asynchronous process. Therefore, something must eventually call and end the transfer after the data has been successfully moved to storage. A timer will be used here to call a method that periodically checks the notification queue for messages indicating a transfer is complete. While using a Web page timer is sufficient for the lab, a worker role or other process may be a more appropriate place to trigger the end of the transfer. <p> <asp:button ID="StartOnDemandTransferButton" runat="server" Text="Start Worker Role Data Transfer" OnClick="StartOnDemandTransferButton_Click" /> <asp:scriptmanager ID="ScriptManager1" runat="server"> </asp:scriptmanager> <asp:timer ID="OnDemandTransferEndTimer" runat="server" ontick="ondemandtransferendtimer_tick"> </asp:timer> </p> Save the Default.aspx file (Control-S). 24

25 9.3 Add functionality to the code-behind file to start and end the on-demand transfer Open the Default.aspx.cs (or Default.aspx.vb in VB) code behind file in the AdminWebRole project by double clicking on the file in the Solution Explorer. 25

26 9.3.2 Add the StartOnDemandTransferButton_Click method to kick off the on-demand transfer of 2 minutes of StoreContestantWorkerRole log data when the user pushes the StartOnDemandTransferButton on the Admin Console. For C# Note: If you do not wish to add this code manually, you can copy and paste the code from the file available at D\WindowsAzure\LabA-DiagnosticsLab\L\Begin. protected void StartOnDemandTransferButton_Click(object sender, EventArgs e) System.Diagnostics.Trace.TraceInformation( "Start on demand transfer of log data"); DeploymentDiagnosticManager deploymentmanager = new DeploymentDiagnosticManager(RoleEnvironment. GetConfigurationSettingValue( "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString"), RoleEnvironment.DeploymentId); IEnumerable<RoleInstanceDiagnosticManager> rolemananagers = deploymentmanager.getroleinstancediagnosticmanagersforrole( "StoreContestantWorkerRole"); DataBufferName datasource = DataBufferName.Logs; OnDemandTransferOptions transferoptions = new OnDemandTransferOptions(); transferoptions.from = DateTime.UtcNow - TimeSpan.FromMinutes(2.0); transferoptions.to = DateTime.UtcNow; string queuename = RoleEnvironment.GetConfigurationSettingValue( "OnDemandTransferCompleteQueue"); transferoptions.notificationqueuename = queuename; foreach (RoleInstanceDiagnosticManager agent in rolemananagers) //make sure the agent does not have active transfers going on. if (agent.getactivetransfers().count <= 0) System.Diagnostics.Trace.TraceInformation("Begin on-demand transfer of data from StoreContestantWorkerRole instance - " + agent.roleinstanceid); agent.beginondemandtransfer(datasource, transferoptions); 26

27 For VB Protected Sub StartOnDemandTransferButton_Click(ByVal sender As Object, ByVal e As EventArgs) System.Diagnostics.Trace.TraceInformation("Start on demand transfer of log data") Dim deploymentmanager As New DeploymentDiagnosticManager(RoleEnvironment.GetConfigurationSettingVal ue("microsoft.windowsazure.plugins.diagnostics.connectionstring"), RoleEnvironment.DeploymentId) Dim rolemananagers As IEnumerable(Of RoleInstanceDiagnosticManager) = deploymentmanager.getroleinstancediagnosticmanagersforrole("storeconte stantworkerrole") Dim datasource As DataBufferName = DataBufferName.Logs Dim transferoptions As New OnDemandTransferOptions() transferoptions.from = DateTime.UtcNow - TimeSpan.FromMinutes(2.0) transferoptions.[to] = DateTime.UtcNow Dim queuename As String = RoleEnvironment.GetConfigurationSettingValue("OnDemandTransferComplete Queue") transferoptions.notificationqueuename = queuename For Each agent As RoleInstanceDiagnosticManager In rolemananagers 'make sure the agent does not have active transfers going on. If agent.getactivetransfers().count <= 0 Then System.Diagnostics.Trace.TraceInformation("Begin on-demand transfer of data from StoreContestantWorkerRole instance - " + agent.roleinstanceid) agent.beginondemandtransfer(datasource, transferoptions) End If Next End Sub 27

28 9.3.3 Add a method, called by the Timer, that checks for messages in the notification queue. Finding a message, it creates an OnDemandTransferInfo object from the message. The OnDemandTransferInfo object provides the details necessary to get a RoleInstanceDiagnosticManager to end the transfer. For C# Note: Again, if you do not wish to add this code manually, you can copy and paste the code from the file available at D\WindowsAzure\LabA-DiagnosticsLab\L\Begin. protected void OnDemandTransferEndTimer_Tick( object sender, EventArgs e) System.Diagnostics.Trace.TraceInformation("End on-demand transfer"); CloudStorageAccount storageaccount = CloudStorageAccount. FromConfigurationSetting( "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString"); CloudQueueClient queueclient = storageaccount.createcloudqueueclient(); string queuename = RoleEnvironment. GetConfigurationSettingValue("OnDemandTransferCompleteQueue"); CloudQueue queue = queueclient.getqueuereference(queuename); queue.createifnotexist(); CloudQueueMessage message; while ((message = queue.getmessage())!= null) OnDemandTransferInfo transferinfo = OnDemandTransferInfo.FromQueueMessage(message); string deploymentid = transferinfo.deploymentid; Guid requestguid = transferinfo.requestid; string roleinstanceid = transferinfo.roleinstanceid; string rolename = transferinfo.rolename; RoleInstanceDiagnosticManager roleinstancediagnosticmanager = storageaccount.createroleinstancediagnosticmanager(deploymentid, rolename, roleinstanceid); System.Diagnostics.Trace.TraceInformation("End on-demand transfer of data from StoreContestantWorkerRole instance - " + roleinstanceid); roleinstancediagnosticmanager.endondemandtransfer(requestguid); queue.deletemessage(message); 28

29 For VB For C# Protected Sub OnDemandTransferEndTimer_Tick(ByVal sender As Object, ByVal e As EventArgs) System.Diagnostics.Trace.TraceInformation("End on-demand transfer") Dim storageaccount As CloudStorageAccount = CloudStorageAccount.FromConfigurationSetting("Microsoft.WindowsAzure.P lugins.diagnostics.connectionstring") Dim queueclient As CloudQueueClient = storageaccount.createcloudqueueclient() Dim queuename As String = RoleEnvironment.GetConfigurationSettingValue("OnDemandTransferComplete Queue") Dim queue As CloudQueue = queueclient.getqueuereference(queuename) queue.createifnotexist() Dim message As CloudQueueMessage = queue.getmessage() While message IsNot Nothing Dim transferinfo As OnDemandTransferInfo = OnDemandTransferInfo.FromQueueMessage(message) Dim deploymentid As String = transferinfo.deploymentid Dim requestguid As Guid = transferinfo.requestid Dim roleinstanceid As String = transferinfo.roleinstanceid Dim rolename As String = transferinfo.rolename Dim roleinstancediagnosticmanager As RoleInstanceDiagnosticManager = storageaccount.createroleinstancediagnosticmanager(deploymentid, rolename, roleinstanceid) System.Diagnostics.Trace.TraceInformation("End on-demand transfer of data from StoreContestantWorkerRole instance - " + roleinstanceid) roleinstancediagnosticmanager.endondemandtransfer(requestguid) queue.deletemessage(message) message = queue.getmessage() End While End Sub The code above requires the use of additional diagnostics namespaces. For VB using Microsoft.WindowsAzure.Diagnostics.Management; using Microsoft.WindowsAzure.Diagnostics; Imports Microsoft.WindowsAzure.Diagnostics Imports Microsoft.WindowsAzure.Diagnostics.Management 29

30 Step 10: Test On-Demand Transfer of Log Data 10.1 Start debugging the application. As you did in the previous labs, start the project in the Compute Emulator by pressing F On the Admin Console, press the Start Worker Role Data Transfer button to kick off the on-demand transfer of StoreContestantWorkerRole log data to Windows Azure Storage After several minutes, check Windows Azure Storage. 30

31 Per step 8 above, open Windows Azure Mmc and connect to the Storage Emulator In the Windows Azure Mmc window, click on the Tables item under devstoreaccount1. A Tables pane appears listing the tables in your Storage Emulator. Find the new WADLogsTable listed in the panel Double click on the WADLogsTable in the panel. A list of records displays in the bottom panel. 31

32 Examine the records. The Message attribute in the table should contain the same data you see in the log trace using the Compute Emulator UI. 32

33 You should also find a new queue (ondemandcompetedqueue) in Windows Azure Storage. This queue is used by the diagnostic manager for on-demand transfer completion. 33

34 Lab Solution Service Definition File (ServiceDefinition.csdef) <?xml version="1.0" encoding="utf-8"?> <ServiceDefinition name="whereareyou" xmlns=" nition"> <WebRole name="whereareyouwebrole" vmsize="extrasmall"> <Sites> <Site name="web"> <Bindings> <Binding name="endpoint1" endpointname="endpoint1" /> </Bindings> </Site> </Sites> <Endpoints> <InputEndpoint name="endpoint1" protocol="http" port="80" /> </Endpoints> <Imports> <Import modulename="diagnostics" /> </Imports> <ConfigurationSettings> <Setting name="gametitle" /> <Setting name="dataconnectionstring" /> <Setting name="gamequeue" /> <Setting name="gamecontainer" /> <Setting name="quizquestionstable" /> <Setting name="geoquizquestionspartition" /> <Setting name="quizcontestantstable" /> <Setting name="geoquizcontestantspartition" /> <Setting name="maxleadersdisplayed" /> </ConfigurationSettings> <LocalResources> <LocalStorage name="whereareyoustorage" cleanonrolerecycle="false" sizeinmb="1" /> </LocalResources> </WebRole> <WebRole name="adminwebrole" vmsize="extrasmall"> <Sites> <Site name="web"> <Bindings> <Binding name="endpoint1" endpointname="endpoint1" /> </Bindings> </Site> </Sites> <Endpoints> <InputEndpoint name="endpoint1" protocol="http" port="8080" /> </Endpoints> <Imports> <Import modulename="diagnostics" /> </Imports> <ConfigurationSettings> <Setting name="dataconnectionstring" /> <Setting name="gamequeue" /> 34

35 <Setting name="gamecontainer" /> <Setting name="quizquestionstable" /> <Setting name="geoquizquestionspartition" /> <Setting name="ondemandtransfercompletequeue" /> </ConfigurationSettings> </WebRole> <WorkerRole name="storecontestantworkerrole" vmsize="extrasmall"> <Imports> <Import modulename="diagnostics" /> </Imports> <ConfigurationSettings> <Setting name="dataconnectionstring" /> <Setting name="gamequeue" /> <Setting name="quizquestionstable" /> <Setting name="geoquizquestionspartition" /> <Setting name="quizcontestantstable" /> <Setting name="geoquizcontestantspartition" /> <Setting name="maxleadersdisplayed" /> </ConfigurationSettings> </WorkerRole> </ServiceDefinition> 35

36 Service Configuration File (ServiceConfiguration.cscfg) <?xml version="1.0" encoding="utf-8"?> <ServiceConfiguration servicename="whereareyou" xmlns=" iguration" osfamily="1" osversion="*"> <Role name="whereareyouwebrole"> <Instances count="1" /> <ConfigurationSettings> <Setting name= "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString" value="usedevelopmentstorage=true" /> <Setting name="gametitle" value="the Geo Game" /> <Setting name="dataconnectionstring" value="usedevelopmentstorage=true" /> <Setting name="gamequeue" value="completedgamequeue" /> <Setting name="gamecontainer" value="gamepicturecontainer" /> <Setting name="quizquestionstable" value="questions" /> <Setting name="geoquizquestionspartition" value="geoquiz" /> <Setting name="quizcontestantstable" value="contestants" /> <Setting name="geoquizcontestantspartition" value="geoquiz" /> <Setting name="maxleadersdisplayed" value="5" /> </ConfigurationSettings> </Role> <Role name="adminwebrole"> <Instances count="1" /> <ConfigurationSettings> <Setting name= "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString" value="usedevelopmentstorage=true" /> <Setting name="dataconnectionstring" value="usedevelopmentstorage=true" /> <Setting name="gamequeue" value="completedgamequeue" /> <Setting name="gamecontainer" value="gamepicturecontainer" /> <Setting name="quizquestionstable" value="questions" /> <Setting name="geoquizquestionspartition" value="geoquiz" /> <Setting name="ondemandtransfercompletequeue" value="ondemandcompletedqueue" /> </ConfigurationSettings> </Role> <Role name="storecontestantworkerrole"> <Instances count="1" /> <ConfigurationSettings> <Setting name= "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString" value="usedevelopmentstorage=true" /> <Setting name="dataconnectionstring" value="usedevelopmentstorage=true" /> <Setting name="gamequeue" value="completedgamequeue" /> <Setting name="quizquestionstable" value="questions" /> <Setting name="geoquizquestionspartition" value="geoquiz" /> <Setting name="quizcontestantstable" value="contestants" /> <Setting name="geoquizcontestantspartition" value="geoquiz" /> <Setting name="maxleadersdisplayed" value="5" /> </ConfigurationSettings> </Role> 36

37 </ServiceConfiguration> WebRole.cs (in WhereAreYouWebRole) using System; using System.Collections.Generic; using System.Linq; using Microsoft.WindowsAzure; using Microsoft.WindowsAzure.Diagnostics; using Microsoft.WindowsAzure.ServiceRuntime; namespace WhereAreYouWebRole public class WebRole : RoleEntryPoint public override bool OnStart() DiagnosticMonitorConfiguration diagconfig = DiagnosticMonitor.GetDefaultInitialConfiguration(); PerformanceCounterConfiguration totalrequestsconfig = new PerformanceCounterConfiguration(); totalrequestsconfig.counterspecifier Applications( Total )\Requests Total"; totalrequestsconfig.samplerate = TimeSpan.FromSeconds(30.0); diagconfig. PerformanceCounters.DataSources.Add(totalRequestsConfig); PerformanceCounterConfiguration requesttimeconfig = new PerformanceCounterConfiguration(); requesttimeconfig.counterspecifier Applications( Total )\Requests/Sec"; requesttimeconfig.samplerate = TimeSpan.FromSeconds(30.0); diagconfig. PerformanceCounters.DataSources.Add(requestTimeConfig); diagconfig.performancecounters.scheduledtransferperiod = TimeSpan.FromMinutes(2.0); DiagnosticMonitor.Start( "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString", diagconfig); return base.onstart(); 37

38 WebRole.vb (in WhereAreYouWebRole) Imports System Imports System.Collections.Generic Imports System.Linq Imports Microsoft.WindowsAzure Imports Microsoft.WindowsAzure.Diagnostics Imports Microsoft.WindowsAzure.ServiceRuntime Public Class WebRole Inherits RoleEntryPoint Public Overrides Function OnStart() As Boolean ' For information on handling configuration changes ' see the MSDN topic at ' Dim diagconfig As DiagnosticMonitorConfiguration = DiagnosticMonitor.GetDefaultInitialConfiguration() Dim totalrequestsconfig As New PerformanceCounterConfiguration() totalrequestsconfig.counterspecifier = "\ASP.NET Applications( Total )\Requests Total" totalrequestsconfig.samplerate = TimeSpan.FromSeconds(30.0) diagconfig.performancecounters.datasources.add(totalrequestsconfig) Dim requesttimeconfig As New PerformanceCounterConfiguration() requesttimeconfig.counterspecifier = "\ASP.NET Applications( Total )\Requests/Sec" requesttimeconfig.samplerate = TimeSpan.FromSeconds(30.0) diagconfig.performancecounters.datasources.add(requesttimeconfig) diagconfig.performancecounters.scheduledtransferperiod = TimeSpan.FromMinutes(2.0) DiagnosticMonitor.Start("Microsoft.WindowsAzure.Plugins.Diagnostics.Co nnectionstring", diagconfig) Return MyBase.OnStart() End Function End Class 38

39 Default.aspx (in AdminWebRole) unmodified portion left out for brevity... </table> </p> <p> <asp:button ID="StartOnDemandTransferButton" runat="server" Text="Start Worker Role Data Transfer" OnClick="StartOnDemandTransferButton_Click" /> <asp:scriptmanager ID="ScriptManager1" runat="server"> </asp:scriptmanager> <asp:timer ID="OnDemandTransferEndTimer" runat="server" OnTick="OnDemandTransferEndTimer_Tick"> </asp:timer> </p> </asp:content> 39

40 Default.aspx.cs (in AdminWebRole) only new methods shown for brevity namespace AdminWebRole using System; using System.Collections.Generic; using System.Text; using Microsoft.WindowsAzure; using Microsoft.WindowsAzure.Diagnostics; using Microsoft.WindowsAzure.Diagnostics.Management; using Microsoft.WindowsAzure.ServiceRuntime; using Microsoft.WindowsAzure.StorageClient; using QuizQuestions; public partial class _Default : System.Web.UI.Page //...existing methods left off for brevity protected void StartOnDemandTransferButton_Click (object sender, EventArgs e) System.Diagnostics.Trace.TraceInformation("Start on demand transfer of log data"); DeploymentDiagnosticManager deploymentmanager = new DeploymentDiagnosticManager(RoleEnvironment. GetConfigurationSettingValue( "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString"), RoleEnvironment.DeploymentId); IEnumerable<RoleInstanceDiagnosticManager> rolemananagers = deploymentmanager.getroleinstancediagnosticmanagersforrole( "StoreContestantWorkerRole"); DataBufferName datasource = DataBufferName.Logs; OnDemandTransferOptions transferoptions = new OnDemandTransferOptions(); transferoptions.from = DateTime.UtcNow TimeSpan.FromMinutes(2.0); transferoptions.to = DateTime.UtcNow; string queuename = RoleEnvironment.GetConfigurationSettingValue( "OnDemandTransferCompleteQueue"); transferoptions.notificationqueuename = queuename; foreach (RoleInstanceDiagnosticManager agent in rolemananagers) //make sure the agent does not have active transfers going on. if (agent.getactivetransfers().count <= 0) System.Diagnostics.Trace.TraceInformation("Begin on-demand transfer of data from StoreContestantWorkerRole instance - " + agent.roleinstanceid); agent.beginondemandtransfer(datasource, transferoptions); 40

41 protected void OnDemandTransferEndTimer_Tick (object sender, EventArgs e) System.Diagnostics.Trace.TraceInformation("End on-demand transfer"); CloudStorageAccount storageaccount = CloudStorageAccount. FromConfigurationSetting( "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString"); CloudQueueClient queueclient = storageaccount.createcloudqueueclient(); string queuename = RoleEnvironment. GetConfigurationSettingValue("OnDemandTransferCompleteQueue"); CloudQueue queue = queueclient.getqueuereference(queuename); queue.createifnotexist(); CloudQueueMessage message; while ((message = queue.getmessage())!= null) OnDemandTransferInfo transferinfo = OnDemandTransferInfo.FromQueueMessage(message); string deploymentid = transferinfo.deploymentid; Guid requestguid = transferinfo.requestid; string roleinstanceid = transferinfo.roleinstanceid; string rolename = transferinfo.rolename; RoleInstanceDiagnosticManager roleinstancediagnosticmanager = storageaccount.createroleinstancediagnosticmanager( deploymentid,rolename, roleinstanceid); System.Diagnostics.Trace.TraceInformation("End on-demand transfer of data from StoreContestantWorkerRole instance - " + roleinstanceid); roleinstancediagnosticmanager.endondemandtransfer(requestguid); queue.deletemessage(message); 41

42 Default.aspx.vb (in AdminWebRole) Imports System.Text Imports Microsoft.WindowsAzure Imports Microsoft.WindowsAzure.ServiceRuntime Imports Microsoft.WindowsAzure.StorageClient Imports QuizQuestions.QuizQuestions Imports Microsoft.WindowsAzure.Diagnostics Imports Microsoft.WindowsAzure.Diagnostics.Management Public Class _Default Inherits System.Web.UI.Page Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Load End Sub Protected Sub RefreshButton_Click(ByVal sender As Object, ByVal e As EventArgs) Dim storageaccount As CloudStorageAccount = CloudStorageAccount.FromConfigurationSetting("DataConnectionString") Dim queueclient As CloudQueueClient = storageaccount.createcloudqueueclient() Dim queuename As String = RoleEnvironment.GetConfigurationSettingValue("GameQueue") Dim queue As CloudQueue = queueclient.getqueuereference(queuename) queue.createifnotexist() Dim messagecount As Integer = queue.retrieveapproximatemessagecount() Dim newtext As New StringBuilder("None") If messagecount > 0 Then Dim messages As IEnumerable(Of CloudQueueMessage) = queue.getmessages(messagecount) newtext = New StringBuilder() For Each message As CloudQueueMessage In messages newtext.appendline(message.asstring) queue.deletemessage(message) Next End If Me.ContestantsTextBox.Text = newtext.tostring() End Sub Protected Sub UploadBlobButton_Click(ByVal sender As Object, ByVal e As EventArgs) Dim storageaccount As CloudStorageAccount = CloudStorageAccount.FromConfigurationSetting("DataConnectionString") Dim blobclient As CloudBlobClient = storageaccount.createcloudblobclient Dim containername As String = RoleEnvironment.GetConfigurationSettingValue("GameContainer") Dim container As CloudBlobContainer = blobclient.getcontainerreference(containername) container.createifnotexist() 42

43 Dim permissions As BlobContainerPermissions = New BlobContainerPermissions permissions.publicaccess = BlobContainerPublicAccessType.Blob container.setpermissions(permissions) Dim blob As CloudBlob = container.getblobreference(me.pictureidtextbox.text) blob.uploadfromstream(me.geopictureupload.filecontent) Server.Transfer("Default.aspx") End Sub Protected Sub AddQuestionButton_Click(ByVal sender As Object, ByVal e As EventArgs) Dim question As New Question() With _.Text = Me.QuestionTextBox.Text, _.ImageName = Me.ImageNameTextBox.Text, _.AnswersString = Me.AnswersTextBox.Text, _.Answer = Integer.Parse(Me.AnswerTextBox.Text) - 1, _.Comment = Me.CommentTextBox.Text _ QuestionDataSource.Add(question) Server.Transfer("Default.aspx") End Sub Protected Sub DeleteQuestionsButton_Click(ByVal sender As Object, ByVal e As EventArgs) QuestionDataSource.DeleteAll() Server.Transfer("Default.aspx") End Sub Protected Sub StartOnDemandTransferButton_Click(ByVal sender As Object, ByVal e As EventArgs) System.Diagnostics.Trace.TraceInformation("Start on demand transfer of log data") Dim deploymentmanager As New DeploymentDiagnosticManager( RoleEnvironment.GetConfigurationSettingValue("Microsoft.WindowsAzure.P lugins.diagnostics.connectionstring"), RoleEnvironment.DeploymentId) Dim rolemananagers As IEnumerable(Of RoleInstanceDiagnosticManager) = deploymentmanager.getroleinstancediagnosticmanagersforrole("storeconte stantworkerrole") Dim datasource As DataBufferName = DataBufferName.Logs Dim transferoptions As New OnDemandTransferOptions() transferoptions.from = DateTime.UtcNow - TimeSpan.FromMinutes(2.0) transferoptions.[to] = DateTime.UtcNow Dim queuename As String = RoleEnvironment.GetConfigurationSettingValue("OnDemandTransferComplete Queue") transferoptions.notificationqueuename = queuename For Each agent As RoleInstanceDiagnosticManager In rolemananagers 'make sure the agent does not have active transfers going on. If agent.getactivetransfers().count <= 0 Then System.Diagnostics.Trace.TraceInformation("Begin on-demand transfer of data from StoreContestantWorkerRole instance - " + agent.roleinstanceid) agent.beginondemandtransfer(datasource, transferoptions) End If 43

44 Next End Sub Protected Sub OnDemandTransferEndTimer_Tick(ByVal sender As Object, ByVal e As EventArgs) System.Diagnostics.Trace.TraceInformation("End on-demand transfer") Dim storageaccount As CloudStorageAccount = CloudStorageAccount.FromConfigurationSetting("Microsoft.WindowsAzure.P lugins.diagnostics.connectionstring") Dim queueclient As CloudQueueClient = storageaccount.createcloudqueueclient() Dim queuename As String = RoleEnvironment.GetConfigurationSettingValue("OnDemandTransferComplete Queue") Dim queue As CloudQueue = queueclient.getqueuereference(queuename) queue.createifnotexist() Dim message As CloudQueueMessage = queue.getmessage() While message IsNot Nothing Dim transferinfo As OnDemandTransferInfo = OnDemandTransferInfo.FromQueueMessage(message) Dim deploymentid As String = transferinfo.deploymentid Dim requestguid As Guid = transferinfo.requestid Dim roleinstanceid As String = transferinfo.roleinstanceid Dim rolename As String = transferinfo.rolename Dim roleinstancediagnosticmanager As RoleInstanceDiagnosticManager = storageaccount.createroleinstancediagnosticmanager(deploymentid, rolename, roleinstanceid) System.Diagnostics.Trace.TraceInformation("End on-demand transfer of data from StoreContestantWorkerRole instance - " + roleinstanceid) roleinstancediagnosticmanager.endondemandtransfer(requestguid) queue.deletemessage(message) message = queue.getmessage() End While End Sub End Class 44

45 WorkerRole.cs (in StoreContestantWorkerRole) using System; using System.Collections.Generic; using System.Diagnostics; using System.Linq; using System.Net; using System.Threading; using Microsoft.WindowsAzure; using Microsoft.WindowsAzure.Diagnostics; using Microsoft.WindowsAzure.ServiceRuntime; using Microsoft.WindowsAzure.StorageClient; using QuizContestants; namespace StoreContestantWorkerRole public class WorkerRole : RoleEntryPoint public override void Run() Trace.WriteLine("StoreContestantWorkerRole entry point called", "Information"); while (true) Thread.Sleep(10000); Trace.WriteLine("Working", "Information"); this.processcontestantresults(); public override bool OnStart() ServicePointManager.DefaultConnectionLimit = 12; DiagnosticMonitor.Start( "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString"); Trace.TraceInformation("Store Contestant Worker Role started."); SetupConfigurationPublisher(); return base.onstart(); private void SetupConfigurationPublisher() CloudStorageAccount.SetConfigurationSettingPublisher( (configname, configsetter) => configsetter( RoleEnvironment.GetConfigurationSettingValue(configName)); ); private void CreateAndSaveContestant(string messagedata) Contestant contestant = new Contestant(messageData); 45

46 ContestantDataSource.Add(contestant); Trace.TraceInformation("Contestant record saved: " + contestant.tostring()); private void ProcessContestantResults() CloudStorageAccount storageaccount = CloudStorageAccount. FromConfigurationSetting("DataConnectionString"); CloudQueueClient queueclient = storageaccount.createcloudqueueclient(); string queuename = RoleEnvironment. GetConfigurationSettingValue("GameQueue"); CloudQueue queue = queueclient.getqueuereference(queuename); queue.createifnotexist(); int messagecount = queue.retrieveapproximatemessagecount(); Trace.TraceInformation( "Checking for completed game messages. Found: " + messagecount); if (messagecount > 0) IEnumerable<CloudQueueMessage> messages = queue.getmessages(messagecount); foreach (var message in messages) this.createandsavecontestant(message.asstring); queue.deletemessage(message); 46

47 WorkerRole.vb (in StoreContestantWorkerRole) Imports System Imports System.Collections.Generic Imports System.Diagnostics Imports System.Linq Imports System.Net Imports System.Threading Imports Microsoft.WindowsAzure Imports Microsoft.WindowsAzure.Diagnostics Imports Microsoft.WindowsAzure.ServiceRuntime Imports Microsoft.WindowsAzure.StorageClient Imports QuizContestants.QuizContestants Public Class WorkerRole Inherits RoleEntryPoint Public Overrides Sub Run() Trace.WriteLine("StoreContestantWorkerRole entry point called.", "Information") While (True) Thread.Sleep(10000) Trace.WriteLine("Working", "Information") Me.ProcessContestantResults() End While End Sub Public Overrides Function OnStart() As Boolean ServicePointManager.DefaultConnectionLimit = 12 DiagnosticMonitor.Start( "Microsoft.WindowsAzure.Plugins.Diagnostics.ConnectionString") Trace.TraceInformation("Store Contestant Worker Role started.") Me.SetupConfigurationPublisher() Return MyBase.OnStart() End Function Private Sub SetupConfigurationPublisher() CloudStorageAccount.SetConfigurationSettingPublisher(Sub(configName, configsetter) _ configsetter(roleenvironment.getconfigurationsettingvalue(configname)) ) End Sub Private Sub CreateAndSaveContestant(ByVal messagedata As String) Dim contestant As New Contestant(messageData) ContestantDataSource.Add(contestant) Trace.TraceInformation("Contestant record saved: " + contestant.tostring) End Sub 47

48 Private Sub ProcessContestantResults() Dim storageaccount As CloudStorageAccount = CloudStorageAccount.FromConfigurationSetting("DataConnectionString") Dim queueclient As CloudQueueClient = storageaccount.createcloudqueueclient() Dim queuename As String = RoleEnvironment.GetConfigurationSettingValue("GameQueue") Dim queue As CloudQueue = queueclient.getqueuereference(queuename) queue.createifnotexist() Dim messagecount As Integer = queue.retrieveapproximatemessagecount() Trace.TraceInformation("Checking for completed game messages. Found: " + messagecount.tostring) If messagecount > 0 Then Dim messages As IEnumerable(Of CloudQueueMessage) = queue.getmessages(messagecount) For Each message As CloudQueueMessage In messages Me.CreateAndSaveContestant(message.AsString) queue.deletemessage(message) Next End If End Sub End Class There are no bonus labs for this lab. 48