MS Teams Integration
SelectorAIOps Microsoft Teams Integration
Selector Software enables customers to monitor, analyze, and share their digital infrastructure performance using Microsoft teams and SelectorAIOps. Selector AI’s analytics and collaboration engine hides the complexity of heterogeneous infrastructure and tools. Our turn-key solution sits on top of disparate information sources to provide visibility, monitoring, correlated real time insights, and alerting for hosts, devices, infrastructure, and network health and performance. We present these insights in a unique collaborative manner between people, machines, and applications acting in unison enabling teams to interact with the SelectorAIOps platform in the collaboration tool of their choice
SelectorAIOps provides actionable multi-dimensional insights to network, cloud, and application operators. It provides a query interface to monitor and analyze events and trends. Users can keep their team updated on performance, view alerts, and share dashboards in the specific Microsoft teams channels where their team collaborates. SelectorAIOps provides these insights by ingesting metrics from multiple data sources and doing analysis on historical metrics and real-time streaming metrics.
Configuration
Before beginning, make sure that you have added the Selector AIOps App to your Teams workspace.
Step 1:Add the Selector AIOPs App to your Microsoft Teams
- Make sure you are signed into your Microsoft Teams account.
- Search for Selector AIOPs in Microsoft Teams Apps, and select Add. You can get this from your Teams app (as shown below), or from the web.
- Before doing this, please make sure you have the appropriate permissions to install apps in your Microsoft Teams account.
- Reach out to your Selector point of contact (Solution Engineer or Sales Engineer) if you have questions.
Step 2: In your Microsoft Teams app, create the Teams channel through which you want to interact with the Selector AIOPs BOT.
Step 3: Collect the Channel ID information for that channel as explained below.
- Note: Your Selector representative should be able to help you with any questions you have.
Extract the Channel ID, which is the portion after
/channel/
ending with.tacv2
(see example above). In the example the extracted Channel id is: 19%3A85af72f0be4646dca7d3230886c6f88b%40threadedit the channel ID as follows:
Remove “%3a” located at the beginning of the extracted Channel ID and replace it with a colon :
Remove “%40” located towards the end of the extracted Channel ID and replace it with “@” sign. From the example above, the edited channel ID now looks like this: 19:85af72f0be4646dca7d3230886c6f88b@thread.
Provide this edited channel ID to your Selector contact (Customer Success or Solutions Engineering representative), who will update some YAML files.
Step 4: Once the previous step is complete, navigate to the Selector integrations dashboard on the Selector S2AP UI to set up Teams integration. Please make sure you have admin access to S2AP.
An example URL is https://*<customer-domain>*.selector.ai/app/integrations.
Please make sure you use the correct URL corresponding to your S2AP instance.
Step 5: Click on install under the Teams integration logo to enable the workflow to add the SelectorAIOps BOT to an MS Teams workspace and an MS Teams channel.
Step 6: In the pop-up window that appears, enter the edited channel ID from Step 3.
If you want to see the alerts in these channels, you should enable alerts in the check box.
You can enable alerts at a later time if you choose. Refer to Step 8 as well.
Click Save.
Step 7: The Microsoft Teams integration should be up and running.
Step 8: If you want to send alerts to Teams channels, go to the Notification provider on the Integrations page, Add a notification provider, and add the edited Teams Channel Id you want to get alerts in. You will need to also provide the correct teams_token and teams_password attributes corresponding to your Teams account.
Note: you can also simply duplicate the auto-created __teams_notif_generic to copy all attributes and update it with the relevant channel IDs.
Then you need to associate the Notification Provider with the corresponding alert rule.
Step 9: Interact with the Selector AIOps App in your teams channel.
Step 10: Execute commands on the channel to check SelectorAIOps’s response in the Teams channel.
See the Operations section for details.
Step 11: To add additional channels from the same MS Teams workspace, navigate to the Selector teams integration dashboard and click on Add.
Step 12: To connect the SelectorAIOps BOT to a new Microsoft teams instance, please delete the current integration by clicking on Delete Integration and repeat the above steps for the new instance.
Operations
Query service using Microsoft teams
You can use following actions with the SelectorAIOps query service:
- Get a report of metrics over a period of time
- Plot metrics as line graph, bar graph, stacked graph, honeycomb, event graph
This is a list of available commands:
- @SelectorAIOps [query]: Query Selector Analytics
- @SelectorAIOps summon: Display a modal to summon a dashboard/widget in MS Teams
- @SelectorAIOps summon [dashboard/widget name]: Summon a dashboard or widget to Teams
- @SelectorAIOps help: Display help Options
Collaborate Using Microsoft Teams
- Users can share and collaborate with other team members in a teams channel
- Users can view alerts and issues in a teams channel
- Users can query S2AP using natural language queries and see the status of their network and devices in a teams channel
- Users can view topology and dashboard widgets in their teams channel
Support
For support and questions, please contact us or send an email to support@selector.ai