Dynatrace-Java-Agent-Ansible

Ta rola Ansible instaluje i konfiguruje agenta Dynatrace AppMon dla procesów Java w rozwiązaniu Dynatrace AppMon.

Uwaga: ta rola sprawia, że agent Dynatrace AppMon jest dostępny dla Maszyny Wirtualnej Java, poprzez dodanie odpowiedniej opcji -agentpath do zmiennej środowiskowej, np. JAVA_OPTS, w pliku (zazwyczaj w skrypcie wykonywalnym). Zakłada się, że ten skrypt uruchamia proces Java bezpośrednio lub jest używany przez inny skrypt przed uruchomieniem procesu Java. Po dodaniu agenta musisz zrestartować swoją aplikację.

Przykład

Mamy plik run-foo.sh, który wykonuje metodę main w klasie Foo:

java Foo

Wykonując tę rolę, zmieniamy zawartość pliku na coś takiego:

export JAVA_OPTS="$JAVA_OPTS -agentpath:/opt/dynatrace/agent/lib64/libdtagent.so=name=foo-java-agent,collector=localhost:9998"
java Foo

Pobieranie

Rola jest dostępna przez:

• Ansible Galaxy
• GitHub

Wymagania

Ta rola zależy od następujących ról:

• Dynatrace-Agent

Zmienne roli

Jak zdefiniowano w defaults/main.yml:

Nazwa	Domyślna	Opis
dynatrace_java_agent_env_var_name	JAVA_OPTS	Nazwa zmiennej środowiskowej używanej do wstrzyknięcia agenta.
dynatrace_java_agent_env_var_file_name	wymagana	Nazwa pliku do zmodyfikowania.
dynatrace_java_agent_env_var_file_insert_after	BOF	Wyrażenie regularne, BOF lub EOF dla początek pliku oraz koniec pliku. Jeśli dane wyrażenie nie zostanie znalezione, opcja -agentpath zostanie dodana na końcu pliku.
dynatrace_java_agent_name	java-agent	Nazwa agenta, jak pojawia się w Dynatrace AppMon.
dynatrace_java_agent_collector_hostname	localhost	Lokalizacja collectora, do którego agent ma się połączyć.
dynatrace_java_agent_collector_port	9998	Port na collectorze, do którego agent ma się połączyć.
dynatrace_java_agent_linux_agent_path	/opt/dynatrace/agent/lib64/libdtagent.so	Ścieżka do biblioteki agenta.
dynatrace_java_agent_state	present	Czy agent ma być present czy absent.

Przykładowy Playbook

- hosts: all
  roles:
    - role: Dynatrace.Dynatrace-Java-Agent
      dynatrace_java_agent_env_var_file_name: /usr/bin/run-foo.sh
      dynatrace_java_agent_env_var_file_insert_after: '#!/bin/sh'

Testowanie

Używamy Test Kitchen do automatycznego testowania naszych automatycznych wdrożeń przy użyciu Serverspec i RSpec:

1. Zainstaluj Test Kitchen i jego zależności z katalogu projektu:

gem install bundler
bundle install

2. Uruchom wszystkie testy

kitchen test

Domyślnie uruchamiamy nasze testy w kontenerach Docker, co znacznie przyspiesza czas testowania (zobacz .kitchen.yml).

Dodatkowe zasoby

Blogi

• Jak zautomatyzować monitorowanie aplikacji przedsiębiorstwa za pomocą Ansible
• Jak zautomatyzować monitorowanie aplikacji przedsiębiorstwa za pomocą Ansible - Część II

Prezentacje

• Zautomatyzowane wdrożenia (Dynatrace AppMon) z Ansible
• Infrastruktura oparta na testach z Ansible, Test Kitchen, Serverspec i RSpec

Problemy? Pytania? Sugestie?

To oprogramowanie jest wspierane przez wspólnotę Dynatrace. Zachęcamy do dzielenia się problemami, pytaniami i sugestiami z innymi w forum Monitoring Aplikacji i UEM społeczności Dynatrace.

Licencja

Licencjonowane na podstawie licencji MIT. Zobacz plik LICENSE dla szczegółów.