Search Results for

    Show / Hide Table of Contents

    Phobos + Azure Application Insights Akka.Cluster Dashboard

    The Phobos + Azure Application Insights Akka.Cluster Dashboard is designed to help your team immediately observe the following things about your Akka.Cluster applications:

    1. The overall state of the cluster - the number of members of each status, each role type, and the total number of unreachable nodes over the past arbitrary window of time.
    2. Error rates and logging activity across the cluster - what do the global logging rates look like and which cluster nodes and logging which types of errors over how much time?
    3. Total actor counts, start / stop rates, crash rates, and message processing - this paints a complete picture of how many actors are alive throughout the cluster, what types of messages are processing, how are actors churning (starts / stops,) and what types of exceptions are being thrown by which actor types?

    Here's a preview of what the Phobos + Azure Application Insights Akka.Cluster Dashboard demonstrates:

    Phobos + Akka.NET Azure Application Insights Workbook cluster and actor overview

    Phobos + Akka.NET Azure Application Insights Workbook actor and message processing overview

    Note

    This dashboard will be installed into your Azure Resource Group as an Azure Monitor Workbook Template, which you will in turn use to create a Workbook that is connected to your own Azure Application Insights resource.

    Installation Instructions

    First, you will need to clone the phobos-dashboards repository from Petabridge's Github account and then open the /appinsights folder.

    To install this Azure Monitor Workbook template into your Azure subscription, you will need to import the ARM template included in the repository into one of your resource groups: https://github.com/petabridge/phobos-dashboards/blob/master/appinsights/phobos-1.x/phobos-appinsights-ARM-template.json

    There are multiple ways you can do this:

    1. Deploy ARM templates via Azure Portal;
    2. Deploy ARM templates via Azure CLI; or
    3. Deploy ARM templates via Azure PowerShell.

    Deploying the Akka.NET Azure Monitor Workbook Template to Your Azure Subscription

    For the purposes of keeping this tutorial as visual as possible, we're going to deploy our Phobos + Akka.NET Cluster Dashboard using an ARM template via the Azure Portal UI that will create an Azure Monitor Workbook template for us.

    Important

    This tutorial assumes that you already have an Azure Resource Group with an active Application Insights resource receiving data from Phobos in it. If you don't have one yet, please create one before attempting to import this dashboard.

    Step 1 - to deploy our ARM template through the Azure portal, select Create a resource, search for template, and then select Template deployment.

    Deploying ARM template via Azure Portal

    Step 2 - select Create and Build your own template in the editor.

    Select Build your own template in the editor

    Step 3 - in the Edit template dialog, copy and paste the JSON from https://github.com/petabridge/phobos-dashboards/blob/master/appinsights/phobos-1.x/phobos-appinsights-ARM-template.json into the editor or if you've cloned it locally, load the JSON file directly via the Load file dialog.

    Editing the Phobos Azure Monitor Akka.NET Workbook Template deployment

    Once that's all finished press Save - and now you'll have a chance to confirm which Resource Group you want to deploy the template in and what you want the Azure Monitor Workbook template to be called.

    Complete Akka.NET Azure Monitor Workbook template deployment

    Press Review + create to move forward and deploy the Azure Monitor Workbook template.

    After a minute or two, you should see the template appear inside your desired resource group:

    ARM deployment executed

    If you click on Go to resource you will be directed to this page:

    Akka.NET + Phobos Azure Monitor Template in resource group

    From there, click on Open Workbook with Azure Monitor to fully make use of this template.

    Create an Azure Monitor Workbook from Template

    Now that we've deployed this template, we need to create a new Azure Monitor Workbook instance that connects this template with our Application Insights data being produced by Phobos.

    When you first open the deployed template instance, you will see several "No Application Insights resources are selected. Please select Application Insights." error messages - we're going to fix this by selecting Edit in the top-left corner of the workbook.

    Edit workbook template

    And then click the gear icon, which will take you to Settings.

    Edit workbook template settings

    Click on Add Resources.

    Add resources to Azure workbook

    And then select your Azure Application Insights resource which contains your Phobos + Akka.NET data for this dashboard and press Apply.

    Add resources to Azure workbook

    Once that's done click Apply Changes and then Save and Close.

    Add resources to Azure workbook

    Your workbook template should now be fully connected to your data from Application Insights - and you'll be able to test this, provided that you've installed Phobos and have it connected to Application Insights, by attempting to select one of your Akka.Cluster nodes from the address parameter.

    Selecting an Akka.NET node in the Azure Application Insights dashboard

    However, none of the data on your charts will render just yet - there is still one more step: we need to save our changes into a new Azure Monitor Workbook, which will allow these charts to begin automatically updating behind the scenes.

    Click on the Done Editing button.

    done editing Azure Monitor workbook template

    And then select Save - pick a resource group and an appropriate name for your workbook!

    Save Akka.NET Phobos Azure Monitor Workbook

    And that's it! You can now view all of your Akka.NET metrics view this workbook.

    Completed Akka.NET Phobos Azure Monitor Workbook

    Note

    This template will be periodically updated by the Petabridge team and possibly other contributors - to stay on top of the most recent changes, please subscribe to notifications on the Phobos Dashboards Github repository: https://github.com/petabridge/phobos-dashboards

    In This Article
    Back to top Generated by DocFX