Добавление Azure Application Insights с помощью подключенных служб Visual Studio

С помощью Visual Studio можно подключить любой из следующих элементов к Azure Application Insights с помощью функции Connected Services:

• Консольное приложение .NET Framework
• ASP.NET Model-View-Controller (MVC) (.NET Framework)
• ASP.NET Core
• .NET Core (включая консольное приложение, WPF, Windows Forms, библиотеку классов)
• Рабочая роль .NET Core
• Функции Azure
• Приложение универсальной платформы Windows
• Xamarin
• Кордова

Функция подключенной службы добавляет все необходимые ссылки и код подключения в проект и изменяет файлы конфигурации соответствующим образом.

Необходимые условия

• Visual Studio с установленной рабочей нагрузкой Azure.
• Проект одного из поддерживаемых типов
• Учетная запись Azure. Если у вас нет учетной записи Azure, активируйте преимущества Azure для подписчиков Visual Studio или зарегистрируйтесь для получения бесплатной пробной версии.

Подключение к Azure Application Insights с помощью подключенных служб

Заметка

Для проектов .NET Framework пользовательский интерфейс подключенных служб немного отличается. Чтобы увидеть различия, сравните версию этой страницы для Visual Studio 2019 .

1. Откройте проект в Visual Studio.

2. В обозревателе решений щелкните правой кнопкой мыши узел подключенных служб и в контекстном меню выберите Добавить, чтобы открыть меню доступных служб.

   

   Если узел Connected Services не отображается, выберите Project>Connected Services>Добавить.

3. Выберите Azure Application Insights. Откроется страница Подключения к зависимости. Вы должны увидеть два варианта: один для локального эмулятора, пакет SDK Application Insights (Локальный) , и один для подключения к активной службе Azure Application Insights. Вы можете сократить затраты и упростить раннюю разработку, начиная с локального эмулятора. Позже вы можете перейти в рабочий сервис, выполнив те же действия и выбрав другую опцию.

   

   Если вы выбираете использовать локально пакет SDK Application Insights, нажмите кнопку Далее, чтобы перейти к экрану сводки изменений, на котором показано, как изменяется ваш проект. В проект добавляется ссылка на пакет NuGet, а код подключения для локального эмулятора добавляется в проект.

   Если вы хотите подключиться к службе Azure, перейдите к следующему шагу или, если вы еще не вошли, войдите в учетную запись Azure, прежде чем продолжить. Если у вас нет учетной записи Azure, вы можете зарегистрироваться для получения бесплатной пробной версии .

4. На экране Настройка Azure Application Insights выберите существующий компонент Azure Application Insights и нажмите кнопку Далее.

   Если вам нужно создать новый компонент, перейдите к следующему шагу. В противном случае перейдите к шагу 7.

   

5. Чтобы создать компонент Application Insights, выполните следующие действия.

   1. Выберите Создать компонент Application Insights в нижней части экрана.

   2. Заполните Application Insights: создать новый экран и выберите Создать.

      

   3. При отображении экрана настройки Azure Application Insights в списке появится новый компонент. Выберите новый компонент в списке и выберите Далее.

6. Введите имя параметра подключения и имя ключа инструментирования или примите значения по умолчанию.

   

   Заметка

   Для повышения безопасности в Visual Studio 17.12 и более поздних версиях этот шаг создает имя параметра подключения; Предыдущие версии создают строку подключения. Строки подключения, хранящиеся в локальной файловой системе, могут создавать угрозу безопасности, если они случайно оказываются доступны.

7. Щелкните Дополнительные параметрыи выберите, где должна храниться строка подключения: в файле локальных секретов или в Azure Key Vault.

   

8. Экран Сводка изменений отображает все изменения, которые будут внесены в ваш проект, если вы завершите процесс. Если изменения выглядят ОК, нажмите кнопку Готово.

   

9. В Обозревателе Решений дважды щелкните узел Подключенных Служб, чтобы открыть вкладку Подключенных Служб. Подключение отображается в разделе Зависимости Службы:

   

   Если щелкнуть три точки рядом с добавленной зависимостью, можно увидеть различные параметры, такие как Connect, чтобы повторно открыть мастер и изменить подключение. Вы также можете щелкнуть три точки в правом верхнем углу окна, чтобы просмотреть параметры для запуска локальных зависимостей, изменения параметров и т. д.

10. Откройте файл кода запуска (Program.cs в шаблонах) и обратите внимание, что строка была добавлена следующим образом:

    builder.Services.AddApplicationInsightsTelemetry(builder.Configuration["APPLICATIONINSIGHTS_CONNECTION_STRING"]);
    

Дальнейшие действия

Сведения о том, как включить мониторинг для вашего приложения в Application Insights для приложений ASP.NET Core.

Для проектов ASP.NET см. в разделе настройте Application Insights для вашего веб-сайта ASP.NET.

Ссылки ведут в раздел статей, следующий за начальными шагами настройки, которые вы уже выполнили.

Связанное содержимое

• страница продукта Azure Monitor
• Документация Azure App Insights