Bindplane

The Bindplane Developer Hub

Welcome to the Bindplane developer hub. You'll find comprehensive guides and documentation to help you start working with Bindplane as quickly as possible, as well as support if you get stuck. Let's jump right in!

Microsoft Azure Notification Hubs

Please refer to the Microsoft Azure Sources topic for additional information on how to configure the LPU, and general Azure Data Collection setup details.

Least Privileged User

Steps:

  1. Using the Azure CLI Client, find the Subscription ID and Tenant ID from your account list
  2. Create a custom RBAC role using the JSON provided. Include your Subscription ID and rename the file to azure.json
  3. Create an Active Directory Service Principal and assign the custom RBAC role t it.

Creating custom roles using the Azure CLI:

https://docs.microsoft.com/en-us/azure/role-based-access-control/custom-roles

Assigning roles using the Azure CLI:

https://docs.microsoft.com/en-us/azure/role-based-access-control/role-assignments-portal

{
  "Name": "LPU NotificationHubs",
  "Description": "LPU for NotificationHubs",
  "Actions": [
    "Microsoft.NotificationHubs/namespaces/*/read",
    "Microsoft.Insights/metrics/*/read",
    "Microsoft.Authorization/*/read"
  ],
  "AssignableScopes": [
    "/subscriptions/[Subscription ID]"
  ]
}

Connection Parameters

NameRequired?Description
Subscription IDRequiredGUID Subscription ID
Tenant IDRequiredGUID Tenant ID (also known as Directory ID)
Client IDRequiredGUID Client ID (also known as Application ID)
Client SecretRequiredThe Secret (also known as Key) corresponding to the Client ID.
Maximum HTTP Retry Time (seconds)The maximum amount of time in seconds to retry each API request when the API is throttling.
HTTP Request Timeout (seconds)The maximum amount of time in seconds before a single HTTP request will fail.

Metrics

API Usage

NameDescription
Average PagesThe average amount of pages needed for a paged resource type.
Average Request RetriesThe average number of retry requests per unique requests made.
Average Retry AttemptsThe average number of retry requests made per unique request that was retried.
Average Retry Wait (Milliseconds)The average amount of time retried requests spent waiting.
Client IDThe client ID used to make API calls.
Failed RequestsThe total number of requests that returned a failure response.
Maximum PagesThe most amount of pages needed for a paged resource type.
Maximum RetriesThe highest number of retries made for a single request.
Maximum Retry Wait (Milliseconds)The most amount of time a retried request spent waiting.
Minimum PagesThe least amount of pages needed for a paged resource type.
Minimum Retry Wait (Milliseconds)The least amount of time a retried request spent waiting.
Other Status ResponsesThe total number of successful requests that responded with some other accepted status.
Request TimeoutsThe total number of requests that timed out waiting for a response.
Requests RetriedThe number of unique requests that were retried.
Retry Status ResponsesThe total number of successful requests that responded with the status TOO MANY REQUESTS (429).
Retry TimeoutsThe total number of requests that needed to be retried, but the request retry time exceeded the maximum retry time.
Status OK ResponsesThe total number of successful requests that responded with the status OK (200).
Subscription IDThe subscription ID used to make API calls.
Successful RequestsThe total number of requests that returned a successful response.
Tenant IDThe tenant ID used to make API calls.
Total Monitor RequestsThe total number of requests made to get monitor metrics.
Total Paged RequestsThe total amount of resource types that required paging.
Total RequestsThe total number of requests made during collection.
Total RetriesThe total number of retry requests that were made.
Unique Monitor RequestsThe number of unique requests made to get monitor metrics.
Unique RequestsThe number of requests made with unique endpoints.

Namespace

NameDescription
Created AtThe time the namespace was created.
CriticalWhether or not the namespace is set as Critical.
EnabledWhether or not the namespace is currently enabled.
IDResource Identifier.
KindSpecifies namespace type.
LocationResource location.
NameMicrosoft Azure resource name.
Namespace TypeType of namespace. Valid values are Messaging and NotificationHub.
Provisioning StateProvisioning state of the Namespace.
Service Bus EndpointEndpoint you can use to perform NotificationHub operations.
SKU NameName of the notification hub SKU.
StatusStatus of the namespace. It can be any of these values:1 = Created/Active, 2 = Creating, 3 = Suspended, 4 = Deleting.
TypeMicrosoft Azure resource type.
Updated AtThe time the namespace was last updated.

Notification Hub

NameDescription
APNS Bad Channel Error Count (Errors)The count of pushes that failed because the token is invalid (APNS status code: 8).
APNS Communication Error Count (Errors)Notification not delivered because of errors communicating with APNS.
APNS Credentials Error Count (Errors)The count of pushes that failed because the PNS did not accept the provided credentials or the credentials are blocked.
APNS Expired Channel Error Count (Errors)The count of token that were invalidated by the APNS feedback channel.
APNS Notification Size Error Count (Errors)The count of pushes that failed because the payload was too large (APNS status code: 7).
APNS Successful Notifications CountThe count of all successful APNS notifications.
Bad Channel Errors Count (Errors)The count of pushes that failed because the channel/token/registrationId in the registration was expired or invalid.
Channel Errors Count (Errors)The count of pushes that failed because the channel was invalid not associated with the correct app throttled or expired.
Delete Operations Count (Operations)Count of Delete Installation Operations.
Failed Incoming Requests CountTotal incoming failed requests for a notification hub.
GCM Authentication Error Count (Errors)The count of pushes that failed because the PNS did not accept the provided credentials the credentials are blocked or the SenderId is not correctly configured in the app (GCM result: MismatchedSenderId).
GCM Bad Channel Error Count (Errors)The count of pushes that failed because the registrationId in the registration was not recognized (GCM result: Invalid Registration).
GCM Communication Error Count (Errors)Notification not delivered because of errors communicating with GCM.
GCM Credentials Error Count (Errors)The count of pushes that failed because the PNS did not accept the provided credentials or the credentials are blocked.
GCM Expired Channel Error Count (Errors)The count of pushes that failed because the registrationId in the registration was expired (GCM result: NotRegistered).
GCM Notification Format Error Count (Errors)The count of pushes that failed because the payload was not formatted correctly (GCM result: InvalidDataKey or InvalidTtl).
GCM Notification Size Error Count (Errors)The count of pushes that failed because the payload was too large (GCM result: MessageTooBig).
GCM Successful Notifications CountThe count of all successful GCM notifications.
GCM Throttled Count (Errors)The count of pushes that failed because GCM throttled this app (GCM status code: 501-599 or result:Unavailable).
GCM Wrong Channel Error Count (Errors)The count of pushes that failed because the registrationId in the registration is not associated to the current app (GCM result: InvalidPackageName).
Get Operations Count (Operations)Count ofGet Installation Operations.
IDResource Identifier.
Incoming MessagesThe count of all successful send API calls.
Incoming Requests CountTotal incoming requests for a notification hub.
Installation Operations Count (Operations)Count of installation management operations.
LocationRegion where resource is deployed.
MPNS Authentication Error Count (Errors)The count of pushes that failed because the PNS did not accept the provided credentials or the credentials are blocked.
MPNS Bad Channel Error Count (Errors)The count of pushes that failed because the ChannelURI in the registration was not recognized (MPNS status: 404 not found).
MPNS Channel Disconnected Error Count (Errors)The count of pushes that failed because the ChannelURI in the registration was disconnected (MPNS status: 412 not found).
MPNS Communication Error Count (Errors)Notification not delivered because of errors communicating with MPNS.
MPNS Credentials Error Count (Errors)The count of pushes that failed because the PNS did not accept the provided credentials or the credentials are blocked.
MPNS Dropped Notifications Count (Errors)The count of pushes that were dropped by MPNS (MPNS response header: X-NotificationStatus: QueueFull or Suppressed).
MPNS Notification Format Error Count (Errors)The count of pushes that failed because the payload of the notification was too large.
MPNS Successful Notifications CountThe count of all successful MPNS notifications.
MPNS Throttled Count (Errors)The count of pushes that failed because MPNS is throttling this app (WNS MPNS: 406 Not Acceptable).
NameMicrosoft Azure resource name.
Outgoing Notifications CountAll outgoing notifications of the notification hub.
Patch Operations Count (Operations)Count of Patch Installation Operations.
Payload Errors Count (Errors)The count of pushes that failed because the PNS returned a bad payload error.
PNS Errors Count (Errors)The count of pushes that failed because there was a problem communicating with the PNS.
Registration Create Count (Operations)The count of all successful registration creations.
Registration Delete Count (Operations)The count of all successful registration deletions.
Registration Get Count (Operations)The count of all successful registration queries.
Registration Operations (Operations)The count of all successful registration operations (creations updates queries and deletions).
Registration Update Count (Operations)The count of all successful registration updates.
Resource GroupThe Resource Group of the Azure resource.
Scheduled Messages CanceledCount of scheduled push notifications Canceled.
Scheduled Messages PendingCount of pending scheduled Notifications.
Scheduled Messages SentCount od scheduled Push Notifications Sent.
Successful Notifications CountThe count of all successful notifications.
TypeMicrosoft Azure resource type.
Upsert Operations Count (Operations)Count of Upsert Installation Operations.
WNS Authentication Error Count (Errors)Notification not delivered because of errors communicating with Windows Live invalid credentials or wrong token.
WNS Bad Channel Error Count (Errors)The count of pushes that failed because the ChannelURI in the registration was not recognized.
WNS Channel Disconnected Error Count (Errors)The notification was dropped because the ChannelURI in the registration is disconnected.
WNS Channel Throttled Error Count (Errors)The notification was dropped because the ChannelURI in the registration is throttled.
WNS Communication Error Count (Errors)Notification not delivered because of errors communicating with WNS.
WNS Credentials Error Count (Errors)The count of pushes that failed because the PNS did not accept the provided credentials or the credentials are blocked.
WNS Dropped Notifications Count (Errors)The notification was dropped because the ChannelURI in the registration is dropped (X-WNS-NotificationStatus: dropped but not X-WNS-DeviceConnectionStatus: disconnected).
WNS Expired Channel Error Count (Errors)The count of pushes that failed because the ChannelURI is expired.
WNS Invalid Token Error Count (Errors)The token provided to WNS is not valid.
WNS Notification Format Error Count (Errors)The format of the notification is invalid.
WNS Notification Size Error Count (Errors)The notification payload is too large.
WNS Successful Notifications CountThe count of all successful WNS notifications.
WNS Throttled Count (Errors)The count of pushes that failed because WNS is throttling this app.
WNS Unreachable Count (Errors)Windows Live is not reachable.
WNS Wrong Token Error Count (Errors)The token provided to WNS is valid but for another application.

Updated 8 months ago

Microsoft Azure Notification Hubs


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.