Add Debugging document (#94)

Signed-off-by: Dave Thaler <[email protected]>

OrcanodeMonitor/Core/Fetcher.cs

@@ -378,6 +378,9 @@ public async static Task UpdateOrcasoundDataAsync(OrcanodeMonitorContext context
                         continue;
                     }
 
+                    // First see if we can find a node by dataplicity ID, so that if a node
+                    // shows up in dataplicity first and Orcasite later, we don't create a
+                    // duplicate entry.
                     Orcanode? node = null;
                     if (attributes.TryGetProperty("dataplicity_id", out var dataplicity_id))
                     {

README.md

@@ -12,6 +12,8 @@ history, and allows real-time notifications via many mechanisms (using [IFTTT](h
 
 For more details, see the [Design note](docs/Design.md).
 
+For troubleshooting info, see the [Debugging note](docs/Debugging.md).
+
 ## Contributing
 
 Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on our code of conduct, and the process for

docs/Debugging.md

@@ -0,0 +1,29 @@
+# Orcanode Monitor Debugging
+
+## Debugging Startup Issues
+
+### Method 1
+
+1. Set the environment variable ASPNETCORE_ENVIRONMENT to "Development"
+2. Save the environment variables which will restart the server
+3. Navigate to the site
+
+### Method 2
+
+1. Go to the app service in [Azure portal](https://portal.azure.com/)
+2. Click on "Console" on the left
+3. Type in the exe name: OrcanodeMonitor.exe
+
+### Method 3
+
+1. Go to https://orcanodemonitor.scm.azurewebsites.net
+2. Under the "Debug console" drop down menu, select "CMD"
+3. Cd to C:\home\site\wwwroot
+4. Type in: dotnet OrcanodeMonitor.dll
+
+## Links
+
+* [Production site](https://orcanodemonitor.azurewebsites.net/)
+* [Staging site](https://orcanodemonitorstaging.azurewebsites.net/)
+* [Azure portal](https://portal.azure.com/)
+* [Blog on how to troubleshoot error 500.30](https://zimmergren.net/solving-asp-net-core-3-on-azure-app-service-causing-500-30-in-process-startup-failure/)

docs/Design.md

@@ -76,6 +76,8 @@ The following state will be stored per orcanode:
 
 ### Configured parameters
 
+**AZURE_SQL_CONNECTIONSTRING**: The connection string for the SQL database to use.  Default: Server=(localdb)\mssqllocaldb;Database=OrcanodeMonitorContext-361a3d40-f3a0-4228-92d0-34532be19b05;Trusted_Connection=True;MultipleActiveResultSets=true
+
 **ORCASOUND_POLL_FREQUENCY_IN_MINUTES**: Service will poll each orcanode at the configured frequency. Default: 5
 
 **ORCASOUND_MAX_UPLOAD_DELAY_MINUTES**: If the manifest file is older than this, the node will be considered offline. Default: 2