Microsoft Teams Rooms - New Relic

The Vantage platform provides robust monitoring and management for AV equipment in meeting rooms. One of its unique features is the ability to integrate with various manufacturer platforms, including New Relic. This document will guide you on how to integrate Vantage with New Relic.

Pre-requisites

Before you begin the integration process, ensure:

1. You have an active Vantage account with licenses for the rooms you wish to monitor.
2. Your Windows Microsoft Teams Rooms are networked, operational, and enabled on Microsoft Teams.
3. You have administrative access to both your Vantage account and New Relic account.

Steps to Integrate Vantage with New Relic

Step 1: Generate New Relic API key

1. Login to New Relic and navigate to the API keys UI page from the user menu by clicking on API keys.
2. To create a new API key, click on the ‘Add a key’ button or the ‘+ New API key’ option, depending on the UI.
3. Choose the User key type.
4. Follow the prompts to name your key and assign it to the appropriate account or application.
5. Once created, you can copy the key to your clipboard. Make sure to store it securely as it is used to authenticate and verify your identity.

Step 2: Enable New Relic integration

1. 1. Log in to your Vantage account.
   2. Navigate to 'Integrations'.
   3. Locate New Relic' and click on 'Add Integration'.
   4. Enter the API Key generated in Step 1 and 'Save'.

Step 3: Install agent on Windows Microsoft Teams Rooms

1. Login to New Relic and click Add Data
2. Select the Windows data source
3. Follow instructions to install the New Relic infrastructure agent

Step 4: Configure Infrastructure Agent

Collect Teams Room Logs

1. Open the file 

   C:\Program Files\New Relic\newrelic-infra\logging.d\logs.yml

2. Add the following to the file

   - name: skype-room
     winevtlog:
       channel: Skype Room System
     attributes:
       logtype: windows_application

Disable telemetry collection (optional)

Vantage does not require telemetry to be collected for agents and can be disabled to reduce the ingest data used.

1. Open the file 

   C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml

2. Add the following to the text file

   enable_process_metrics: false
   metrics_process_sample_rate: -1
   metrics_network_sample_rate: -1
   metrics_storage_sample_rate: -1
   metrics_system_sample_rate: -1

PowerShell Script

Alternatively you can run the provided PowerShell script to apply the above configurations

# Automated PowerShell script for installing New Relic Infrastructure agent for Microsoft Teams Rooms

# Teams Room Logs
$teamsRoomLogs = @"
  - name: skype-room
    winevtlog:
      channel: Skype Room System
    attributes:
      logtype: windows_application
"@

# Append the new logging configuration to the existing file
$loggingConfigPath = "C:\Program Files\New Relic\newrelic-infra\logging.d\logs.yml"
Write-Host "Appending to existing logging configuration..."
Add-Content -Path $loggingConfigPath -Value $teamsRoomLogs

# Read the default New Relic Infrastructure configuration
$infraConfigPath = "C:\Program Files\New Relic\newrelic-infra\newrelic-infra.yml"
$defaultConfig = Get-Content -Path $infraConfigPath -Raw

# Retrieve the device serial number
$serialNumber = (Get-WmiObject win32_bios).SerialNumber
Write-Host "Device serial number detected: $serialNumber"

# Add serial number to custom attributes
$defaultConfig = $defaultConfig -replace "(?s)(custom_attributes:\s+nr_deployed_by: newrelic-cli)(\r?\n)", "`$1`r`n  device_serial_number: '$serialNumber'"

# New settings to be appended
$newSettings = @"
enable_process_metrics: false
metrics_process_sample_rate: -1
metrics_network_sample_rate: -1
metrics_storage_sample_rate: -1
metrics_system_sample_rate: -1
"@

# Combine default config with new settings
$combinedConfig = $defaultConfig + $newSettings

# Write the combined configuration back to the file
Write-Host "Appending new configuration settings..."
Set-Content -Path $infraConfigPath -Value $combinedConfig -Force

# Restart the New Relic service
$serviceName = "newrelic-infra"
Write-Host "Restarting the New Relic service..."
Restart-Service -Name $serviceName -Force

Write-Host "New Relic Infrastructure agent installation, configuration, and service restart complete."

Data collected by integration