Развёртка OneAgent на IBM Cloud Foundry для мониторинга только приложений

Материал из Dynatrace

Приложения, развернутые в Cloud Foundry, обычно запускаются с помощью пакетов сборки для конкретных технологий, которые обеспечивают поддержку среды и среды выполнения для приложений, работающих на платформе Cloud Foundry. Для получения полной информации см. Как работают пакеты сборки.

Примечание. При развертывании в режиме только для приложений OneAgent отслеживает память, диск, ЦП и сетевые процессы только внутри контейнера. Показатели хоста не отслеживаются.

Предварительные требования

Создайте токен PaaS.

Просмотрите поддерживаемые приложения и версии.

Развернуть OneAgent

1. Создайте службу Dynatrace в своей среде IBM Cloud Foundry.

Существует два способа определения экземпляра службы, выберите один из них:

Вариант 1. Создайте предоставляемую пользователем услугу

Создайте один экземпляр службы для Dynatrace с именем dynatrace в качестве подстроки, как в примере ниже. Затем вам будет предложено ввести идентификатор среды и токен API. Токен API соответствует упомянутому выше токену.

Dynatrace SaaS

cf cups dynatrace-service -p "environmentid, apitoken"

Dynatrace Managed

cf cups dynatrace-service -p "environmentid, apitoken, apiurl"

Параметр apiurl указывает конечную точку API вашего кластера Dynatrace и должен иметь значение https://<YourDynatraceClusterURL>/e/<environmentID>/api.

Вариант 2. Создайте экземпляр службы через брокера служб.

Если вы хотите хранить учетные данные Dynatrace централизованно, используйте брокера услуг. Для получения подробной информации посетите GitHub. Вам необходимо настроить и запустить брокер как приложение, добавить сервис-брокер в Cloud Foundry, разрешить доступ к сервису для пользователей и, наконец, создать экземпляр сервиса.

2. Привяжите службу Dynatrace к своему приложению.

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

В случае приложения Java, если вы выполняете развертывание в IBM Cloud Foundry, обязательно примите лицензии IBM, установив соответствующие переменные среды. Подробнее см. в файле readme пакета сборки.

---
applications:
- name: demo-helloworld
  path: target/JavaHelloWorldApp.war
  buildpack: https://github.com/cloudfoundry/ibm-websphere-liberty-buildpack.git
  memory: 512M
  instances: 1
  host: hello-world-${random-word}
  disk_quota: 1024M
services:
  - dynatrace-service
env:
  IBM_LIBERTY_LICENSE: <liberty-license-key>
  IBM_JVM_LICENSE: <jvm-license-key>

3. (необязательно) Настройте поток журналов OneAgent по умолчанию для Cloud Foundry.

По умолчанию журналы OneAgent записываются в стандартный поток ошибок Cloud Foundry. Все, что вам нужно сделать, это установить для переменной среды DT_LOGSTREAM значение stdout или stderr.

cf set-env APP_NAME DT_LOGSTREAM stdout

4. (необязательно) Настройте адрес прокси.

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

cf set-env <application> DT_PROXY <proxy address>

5. (необязательно) Настройте сетевые зоны.

Вы можете настроить сетевые зоны двумя способами.

  • Через UserProvidedService:
cf cups dynatrace-service -p "environmentid, apitoken, networkzone"
  • В качестве переменной среды для каждого приложения:
cf set-env <application> DT_NETWORK_ZONE <your_network_zone>

Дополнительные сведения см. в разделе «Сетевые зоны».