Pushover in Funnel Cake (or newer)

18 Sep

Revision for “Pushover in Funnel Cake (or newer)” created on October 14, 2016 @ 01:03:46

Title
Pushover in Funnel Cake (or newer)
Content
With the 0.8.1 release of Funnel Cake, Nightscout users have new options for controlling Pushover notifications. These notes assume you already: <ol> <li>Have set up a <a href="#installPushover">Pushover</a> account.</li> <li>Know your <a href="#pushoverKey">Pushover user key</a> (generated after you create your Pushover account).</li> <li>Have created a <a href="https://pushover.net/apps/build">Pushover application</a> for Nightscout. (You only need to set the Application name; You can ignore all the other settings. If you want a custom Nightscout icon associated with your Pushover notifications, you can use the one located <a href="https://raw.githubusercontent.com/nightscout/cgm-remote-monitor/master/static/images/large.png">here</a>.)</li> <li>Have <a href="/wiki/welcome/how-to-update-to-latest-cgm-remote-monitor-aka-cookie">updated</a> your site to Funnel Cake 0.8.1.</li> </ol> <a name="installPushover"></a> <h2>Setting Up and Installing Pushover</h2> You will need to register for a Pushover account on the <a href="https://pushover.net/">Pushover website</a> and <em>also</em> install <a href="https://pushover.net/clients">the app</a> on your device. The Pushover app comes with a 7-day free trial. Using it after the free trial requires a nominal one-time licensing fee, per user. The Pushover free service includes up to 7,500 notifications per application. <h2>Enabling Pushover</h2> Like other site features, if you wish to use Pushover, you must enter "pushover" in the box next to ENABLE. <a href="http://www.nightscout.info/wp-content/uploads/2015/09/fc-enable-pushover.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/fc-enable-pushover.png" alt="fc-enable-pushover" width="502" height="26" class="alignnone size-full wp-image-2776" style="margin:20px; border: solid black thin;" /></a> (<strong>Reminder:</strong> Only <strong>one</strong> ENABLE variable can be set. If you already have ENABLE, just add "pushover" to the value box, with a space between it and any other values that are already configured. ENABLE should be set in the App Settings area for Azure.) <h2>Configuring Pushover Notifications from Nightscout</h2> It is often recommended to put variables that contain private or password information in the Connection Strings area of Azure with the type set to "Custom." Other variables described in this document should go in the App Settings area. <strong>Note:</strong> These variables will all work in App Settings. The following variables are used to configure Nightscout to use Pushover and allow you to specify the type(s) of information you want to receive from Pushover. <ul> <li style="padding-bottom: 6px;"><strong>PUSHOVER_API_TOKEN</strong>: (<em>required</em>) Enter the API_TOKEN for the application you created. (After creating your application, you can find your key by clicking the name of your application on the Pushover site. Your API_TOKEN will be shown on the screen that loads.) <a href="http://www.nightscout.info/wp-content/uploads/2015/09/pushover-api.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/pushover-api.png" alt="pushover-api" width="410" height="147" class="alignnone size-full wp-image-2772" style="margin:20px; border: solid black thin;" /></a> <a href="http://www.nightscout.info/wp-content/uploads/2015/09/pushover-sample-apikey.png"><img src="http://www.nightscout.info/wp-content/uploads/2015/09/pushover-sample-apikey.png" alt="pushover-sample-apikey" width="578" height="196" class="alignnone size-full wp-image-2773" style="margin:20px; border: solid black thin;" /></a> <em>(The API_TOKEN shown above is a sample only. Your key will be unique.)</em> </li> <a name="pushoverKey"></a> <li style="padding-bottom: 6px;"><strong>PUSHOVER_USER_KEY</strong>: (<em>optional</em>) Enter your Pushover user key, found in the top left of the Pushover site when you are logged in. This variable can hold a space-delimited list of keys (for multiple Pushover account holders or Pushover "groups"). <strong>Configuring this Pushover variable sends "info"-level notifications, including treatment notifications.</strong> To disable info-level notifications, enter "off" as the value (instead of a user key). </li> <li style="padding-bottom: 6px;"><strong>PUSHOVER_ALARM_KEY</strong>: (<em>optional</em>) Enter your Pushover user key (or space-delimited list of keys) to receive system-wide alarms (e.g., warning- or urgent-level alerts). If you do not set a user key for this variable <em>or</em> disable it (by setting it to "off"), alarm-level notifications will be sent to the same user keys specified in the general PUSHOVER_USER_KEY setting (described above). </li> <li style="padding-bottom: 6px;"><strong>PUSHOVER_ANNOUNCEMENT_KEY</strong> (<em>optional</em>) Enter your Pushover user key (or space-delimited list of keys) to receive notifications of user-generated announcements (created using Care Portal). If you do not set a user key for this variable <em>or</em> disable it (by setting it to "off"), announcements will default to the PUSHOVER_USER_KEY or PUSHOVER_ALARM_KEY recipients.</li> <li style="padding-bottom: 6px;"><strong>BASE_URL</strong>: (<em>recommended</em>) The BASE_URL is used to enable Pushover callbacks. Setting the BASE_URL allows you to "acknowledge" an alarm from Pushover and, by doing so, snooze it. The BASE_URL is typically your site url: <span style="color: red;">https://YOURSITE.azurewebsites.net</span>. </li> <li style="padding-bottom: 6px;"><strong>API_SECRET</strong>: (<em>required</em>) An API_SECRET must be set for the site to sign the Pushover callback request for acknowledgments. (If you use Care Portal, you already have an API_SECRET set. It can only be specified one time.)</li> </ul> <h2>Usage Examples</h2> The following examples show possible configurations of Pushover notifications from Nightscout: <ul> <li style="padding-bottom: 6px;">If you want to receive everything, set: <blockquote> PUSHOVER_USER_KEY = youRuSerKeygoesHere </blockquote> </li> <li style="padding-bottom: 6px;">If you want to <strong>only</strong> receive treatment notifications (and info-level information), set: <blockquote> PUSHOVER_USER_KEY = youRuSerKeygoesHere PUSHOVER_ALARM_KEY = off PUSHOVER_ANNOUNCEMENT_KEY = off </blockquote> </li> <li style="padding-bottom: 6px;">If you <strong>don't</strong> want to receive treatment notifications, but you want alarm notifications, set: <blockquote> PUSHOVER_USER_KEY = off PUSHOVER_ALARM_KEY = youRuSerKeygoesHere PUSHOVER_ANNOUNCEMENT_KEY = off </blockquote> </li> <li style="padding-bottom: 6px;">If you want to receive treatment notifications (yourself) but want a different user or user group to also receive announcements and alarms, set: <blockquote> PUSHOVER_USER_KEY = youRuSerKeygoesHere PUSHOVER_ALARM_KEY = youRuSerKeygoesHere SeconduSerKeygoesHere PUSHOVER_ANNOUNCEMENT_KEY = youRuSerKeygoesHere SeconduSerKeygoesHere </blockquote> </li> <li style="padding-bottom: 6px;">If you want to receive treatment notifications (yourself) but want a specific user (e.g., the T1D) or group to receive announcements but not alarms, set: <blockquote> PUSHOVER_USER_KEY = youRuSerKeygoesHere PUSHOVER_ALARM_KEY = youRuSerKeygoesHere PUSHOVER_ANNOUNCEMENT_KEY = youRuSerKeygoesHere SeconduSerKeygoesHere </blockquote> </li> </ul> Using the above examples as a guide, you can configure Pushover notification settings to match your own needs. Keep in mind that to get an individual USER_KEY, each user needs to have a Pushover account and the Pushover app on his/her phone. <h2>Be Careful Acknowledging from Pushover</h2> If you don't acknowledge an alarm from Pushover, it will continue to alarm in Pushover as well as on other devices (and in open browsers). The way Pushover integration with Nightscout has been designed, any user receiving a Pushover alarm can acknowledge it and thus snooze the alarm for all other devices. <strong>Be very careful.</strong> If you need, for example, a caregiver to notice and acknowledge an alarm, you may not want to snooze it yourself. <h2>Customizing Snooze Levels</h2> The following variables can be used to change the available snooze options. These are related to Pushover notifications because the <strong>first</strong> value entered for each of these variables is the duration that Pushover will use if you snooze an alarm by "acknowledging" it from Pushover. To configure these variables, enter each variable name (shown in bold) as a separate variable with your chosen setting(s) as the value(s) for the variable. These should be configured in App Settings in Azure. The default settings for each alarm are shown in () marks: <ul> <li><strong>ALARM_URGENT_HIGH_MINS</strong> (30 60 90 120) This variable specifies the number of minutes to snooze urgent high alarms. All values in the space-separated list are shown as options in a browser. The first value is used for a Pushover-generated snooze.</li> <li><strong>ALARM_HIGH_MINS</strong> (30 60 90 120) This variable specifies the number of minutes to snooze high alarms. All values in the space-separated list are shown as options in a browser. The first value is used for a Pushover-generated snooze.</li> <li><strong>ALARM_LOW_MINS</strong> (15 30 45 60) This variable specifies the number of minutes to snooze low alarms. All values in the space-separated list are shown as options in a browser. The first value is used for a Pushover-generated snooze.</li> <li><strong>ALARM_URGENT_LOW_MINS</strong> (15 30 45) This variable specifies the number of minutes to snooze urgent low alarms. All values in the space-separated list are shown as options in a browser. The first value is used for a Pushover-generated snooze.</li> <li><strong>ALARM_URGENT_MINS</strong> (30 60 90 120)This variable specifies the number of minutes to snooze urgent alarms (that aren't tagged as high or low). All values in the space-separated list are shown as options in a browser. The first value is used for a Pushover-generated snooze. </li> <li><strong>ALARM_WARN_MINS</strong> (30 60 90 120) This variable specifies the number of minutes to snooze warning alarms (that aren't tagged as high or low). All values in the space-separated list are shown as options in a browser. The first value is used for a Pushover-generated snooze. </li> </ul> Be careful setting snooze duration values and the Pushover snooze duration. It may be tempting to set a very long default snooze duration, but be very careful so that you don't miss important site information because alarms have been configured to snooze for extended periods of time. Note that the snooze levels above correspond (by name) to the following alarm types, which you can also configure in your site (Azure or Heroku) settings. All of these alarms are "on" by default and are related to your custom high and low settings and alarm types: <ul> <li><strong>ALARM_URGENT_HIGH</strong> (on) - possible values on or off</li> <li><strong>ALARM_HIGH</strong> (on) - possible values on or off</li> <li><strong>ALARM_LOW</strong> (on) - possible values on or off</li> <li><strong>ALARM_URGENT_LOW</strong> (on) - possible values on or off</li> </ul> <h2>Additional Alarm and Alert Variables</h2> Depending on your configuration, info-, warning-, and urgent-level alarms and alerts may be sent using Pushover. The following alarm and alert variables can also be customized: <ul> <li><strong>ERRORCODES_INFO</strong> (For Dexcom error codes. By default the "needs calibration" (blood drop) and other codes below 9 generate an info-level notification. Enter a space-separated list of numbers (error codes) to specify the errors for which you want an info-level notification <em>or</em> set the value as "off" to disable. The list of Dexcom error codes, by number: <blockquote> 1: 'SENSOR_NOT_ACTIVE', 2: 'MINIMAL_DEVIATION', 3: 'NO_ANTENNA', 5: 'SENSOR_NOT_CALIBRATED', 6: 'COUNTS_DEVIATION', 9: 'ABSOLUTE_DEVIATION', 10: 'POWER_DEVIATION', 12: 'BAD_RF' </blockquote> </li> <li><strong>ERRORCODES_WARN</strong> (off) By default there are no warnings configured for Dexcom error codes. Enter a space-separated list of numbers (error codes) to specify the errors for which you want a warning-level notification <em>or</em> set the value as "off" to disable.</li> <li><strong>ERRORCODES_URGENT</strong> (9 10) By default the hourglass (9) and ??? (10) generate an urgent alarm. Enter a space-separated list of numbers (error codes) to specify the errors for which you want an urgent-level notification <em>or</em> set the value as "off" to disable.</li> <li><strong>CAGE_INFO</strong> (See <a href="/wiki/welcome/website-features/funnel-cake-0-8-features/cage-cannula-age">CAGE</a>)</li> <li><strong>CAGE_WARN</strong> (See <a href="/wiki/welcome/website-features/funnel-cake-0-8-features/cage-cannula-age">CAGE</a>)</li> <li><strong>CAGE_URGENT</strong> (See <a href="/wiki/welcome/website-features/funnel-cake-0-8-features/cage-cannula-age">CAGE</a>)</li> <li><strong>ALARM_TIMEAGO_WARN</strong> (on) possible values <em>on</em> or <em>off</em> <em>(may not yet be integrated with Pushover)</em></li> <li><strong>ALARM_TIMEAGO_WARN_MINS</strong> (15) When the number of minutes since the last reading hits this value, a warning is triggered.</li> <li><strong>ALARM_TIMEAGO_URGENT</strong> (on) - possible values <em>on</em> or <em>off</em> <em>(may not yet be integrated with Pushover)</em></li> <li><strong>ALARM_TIMEAGO_URGENT_MINS</strong> (30) When the number of minutes since the last reading hits this value, an urgent alarm is triggered. <li><strong>BWP-related alarms and warnings.</strong> (See <a href="/wiki/welcome/website-features/funnel-cake-0-8-features/bwp-bolus-wizard-preview">BWP</a>) </ul> <strong>Note:</strong> There are <strong>many</strong> layers of alarms and warnings at work on a Funnel Cake site, including BWP-generated alarms. Integration and/or customized control of some alarms with Pushover may still be under development. You may also find that alarms do not always behave as you expect. Alarms and notifications may be very helpful, but you should also be aware of your site data even in the absence of alarms. <strong>If you encounter problems with alarms, please report them.</strong><em> <br /><br /> Older information regarding setting up Pushover can be found <a href="/wiki/labs/pushover">here</a>.
Excerpt


OldNewDate CreatedAuthorActions
October 14, 2016 @ 01:03:46 Amy Cowen
September 19, 2015 @ 20:38:58 Amy Cowen
September 19, 2015 @ 20:38:04 Amy Cowen
September 19, 2015 @ 20:37:43 [Autosave] Amy Cowen
September 19, 2015 @ 20:07:18 Amy Cowen
September 19, 2015 @ 16:25:58 Amy Cowen
September 18, 2015 @ 23:35:43 Amy Cowen
September 18, 2015 @ 23:34:29 Amy Cowen
September 18, 2015 @ 23:27:26 Amy Cowen
September 18, 2015 @ 23:24:55 Amy Cowen
September 18, 2015 @ 23:24:29 Amy Cowen
September 18, 2015 @ 23:21:51 Amy Cowen
September 18, 2015 @ 23:17:32 Amy Cowen
September 18, 2015 @ 23:16:52 Amy Cowen
September 18, 2015 @ 23:14:00 Amy Cowen