Rola Ansible dla agenta infrastruktury New Relic

Ta rola instaluje i konfiguruje agenta infrastruktury New Relic.

Pamiętaj, że jest to prosta rola i jest przeznaczona jako punkt wyjścia do twojego własnego, dostosowanego przepływu pracy.

Instalacja i używanie roli Ansible

Co robi newrelic-infra

• Dodaje źródło repozytoriów pakietów New Relic.
• Instaluje i konfiguruje agenta infrastruktury New Relic.

Jak zacząć korzystać z roli

Zacznij od dodania roli do swojego playbooka i dostosowania wymaganych zmiennych.

Wszystkie typowe interakcje z newrelic-infra odbywają się przez konfigurację roli.

Instalacja agenta infrastruktury za pomocą roli

Użyj poniższego fragmentu, aby zainstalować agenta.

---
- hosts: ap_ne_1
  roles:
    - name: newrelic.newrelic-infra
      vars:
        nrinfragent_config:
          license_key: TWOJ_KLUCZ_LICENCYJNY
          log_file: /var/log/nr-infra.log
          log_to_stdout: false

Referencja

Konfiguracja roli

Zmienne

nrinfragent_config (Wymagane)

Służy do wypełnienia konfiguracji agenta. Musisz podać przynajmniej license_key. Aby uzyskać obecne opcje konfiguracji, zobacz dokumentację New Relic.

nrinfragent_state (Opcjonalne)

Opisuje, co chcesz zrobić z agentem:

• 'latest' - [domyślne] zainstaluj najnowszą wersję agenta. Też present.
• 'absent' - odinstaluj agenta.

nrinfragent_os_name (Opcjonalne)

Określa system operacyjny, na którym zostanie zainstalowany agent infrastruktury. Domyślnie jest to ansible_os_family. Aby zobaczyć listę obsługiwanych systemów operacyjnych, zobacz plik meta/main.yml.

nrinfragent_os_version (Opcjonalne)

Określa wersję systemu operacyjnego potrzebną do zainstalowania pakietu na tej maszynie. Domyślnie jest to ansible_lsb.major_release. Głównie używane dla systemów rodziny RedHat. Aby zobaczyć listę obsługiwanych systemów operacyjnych, zobacz plik meta/main.yml.

nrinfragent_os_codename (Opcjonalne)

Określa kodową nazwę systemu operacyjnego potrzebną do zainstalowania pakietu na tej maszynie. Domyślnie jest to ansible_lsb.codename. Głównie używane dla systemów rodziny Debian. Aby zobaczyć listę obsługiwanych systemów operacyjnych, zobacz plik meta/main.yml.

nrinfragent_choco_version (Opcjonalne)

Określa wersję pakietu Chocolatey do zainstalowania newrelic-infra na Windows. Może być użyta do zablokowania wersji lub aktualizacji agenta.

nrinfragent_service_state (Opcjonalne)

Określa stan usługi newrelic-infra po instalacji. Domyślnie jest started, co zapewnia, że usługa będzie działać. Możesz zmienić to na stopped, aby zainstalować ją bez uruchamiania od razu.

nrinfragent_service_enabled (Opcjonalne)

Określa, czy usługa uruchomi się przy starcie systemu. Domyślnie jest yes; zmień na no, aby zapobiec automatycznemu uruchamianiu usługi.

nrinfragent_integrations (Opcjonalne)

Określa integracje infrastruktury, które mają być zainstalowane. Lista dostępnych integracji znajduje się tutaj.

Każdy pakiet powinien podać swoją name i state. Nazwa pakietu integracji znajduje się w sekcji Instalacja i aktywacja dokumentów indywidualnych integracji. Zgodnie z konwencją, ich nazwa to nazwa usługi z prefiksem nri- (nri-apache, nri-redis itp.).

Domyślnie ich stan to absent, co oznacza, że pakiet nie jest instalowany; możesz zmienić to na latest lub present. Na przykład:

nrinfragent_integrations:
  - { name: nri-nginx, state: "latest" }
  - { name: nri-mysql, state: "absent" }

Kod źródłowy każdej integracji jest dostępny na GitHubie New Relic.

Usuwanie pakietu newrelic-infra-integrations i jego zintegrowanych integracji

To dotyczy tylko, jeśli masz zainstalowany pakiet newrelic-infra-integrations

Jeśli chcesz usunąć pakiet newrelic-infra-integrations lub jakąkolwiek z zainstalowanych integracji (nri-redis, nri-cassandra, nri-apache, nri-nginx, nri-mysql), dodaj newrelic-infra-integrations jako pierwszy element nrinfragent_integrations z wartością absent.

nrinfragent_integrations:
  - { name: newrelic-infra-integrations, state: "absent" }

Przestarzałe

Możesz określić klucz licencyjny dla zgodności wstecznej. Zalecamy użycie license_key w nrinfragent_config zamiast tego. Jeśli oba są określone, to w nrinfragent_config ma pierwszeństwo.

Zgodność

Platformy

• RHEL/CentOS
  • RHEL/CentOS 8
  • RHEL/CentOS 7
  • RHEL/CentOS 6
  • RHEL/CentOS 5
• Ubuntu
  • 18 Bionic
  • 16 Xenial
  • 14 Trusty
  • 12 Precise
• Debian
  • 10 Buster
  • 9 Stretch
  • 8 Jessie
  • 7 Wheezy
• SUSE Linux Enterprise
  • 12
• Windows
  • Wszystkie
  • Zrzeczenie się: Wsparcie dla Windows zależy od pakietu Chocolatey newrelic-infra strony trzeciej, który jest utrzymywany przez @ripclawffb i @xandrellas. Jest dystrybuowany bez jakiejkolwiek gwarancji lub wsparcia od New Relic.

Wydanie do Ansible Galaxy

Aby wydać nową wersję do Ansible Galaxy, postępuj zgodnie z tymi krokami:

• Zaktualizuj CHANGELOG.md
• Stwórz nową wersję w GitHubie.
• Upewnij się, że wersja została zaimportowana do Ansible Galaxy, jeśli wystąpił jakiś problem, poproś jednego z właścicieli projektu.

Wsparcie

Jeśli potrzebujesz pomocy w kwestiach związanych z produktami New Relic, jesteś w dobrych rękach z wieloma narzędziami diagnostycznymi i kanałami wsparcia.

Jeśli problem został potwierdzony jako błąd lub prośba o nową funkcję, zgłoś problem na GitHubie.

Kanały wsparcia

• Dokumentacja New Relic: Szczegółowe informacje dotyczące korzystania z naszej platformy
• Społeczność New Relic: Najlepsze miejsce na pytania dotyczące rozwiązywania problemów
• Deweloper New Relic: Zasoby do budowania niestandardowych aplikacji do obserwacji
• Uniwersytet New Relic: Szereg szkoleń online dla użytkowników New Relic na każdym poziomie
• Wsparcie techniczne New Relic dostępne 24/7/365. Przeczytaj więcej o naszych ofertach wsparcia technicznego.

Prywatność

W New Relic traktujemy Twoją prywatność i bezpieczeństwo Twoich informacji poważnie i zobowiązujemy się do ochrony Twoich danych. Musimy podkreślić znaczenie niewdzielenia danych osobowych w publicznych forach i prosimy wszystkich użytkowników o usuwanie w logach i informacjach diagnostycznych wrażliwych informacji, czy to osobowych, czy chronionych.

Definiujemy „Dane osobowe” jako wszelkie informacje dotyczące zidentyfikowanej lub możliwej do zidentyfikowania osoby, w tym, na przykład, twoje imię, numer telefonu, kod pocztowy lub ZIP, ID urządzenia, adres IP i adres e-mail.

Aby uzyskać więcej informacji, zapoznaj się z Ogólnym powiadomieniem o prywatności danych New Relic.

Współpraca

Zachęcamy do współpracy, aby poprawić ten projekt! Pamiętaj, że po przesłaniu prośby o włączenie musisz podpisać CLA za pomocą kliknięcia w CLA-Assistant. Musisz podpisać CLA tylko raz na projekt.

Jeśli masz jakiekolwiek pytania lub chcesz zrealizować nasze korporacyjne CLA (które jest wymagane, jeśli Twoja współpraca dotyczy firmy), skontaktuj się z nami na adres opensource@newrelic.com.

Uwaga dotycząca luk w zabezpieczeniach

Jak zaznaczone w naszej polityce bezpieczeństwa, New Relic zobowiązuje się do prywatności i bezpieczeństwa naszych klientów oraz ich danych. Uważamy, że współpraca w zakresie ujawniania informacji przez badaczy bezpieczeństwa oraz zaangażowanie z społecznością bezpieczeństwa są ważnymi środkami osiągnięcia naszych celów bezpieczeństwa.

Jeśli uważasz, że odkryłeś lukę w zabezpieczeniach w tym projekcie lub w którymkolwiek z produktów lub stron internetowych New Relic, cieszymy się i bardzo doceniamy, że zgłosisz to do New Relic przez HackerOne.

Jeśli chciałbyś współpracować nad tym projektem, zapoznaj się z tymi wytycznymi.

Dziękujemy wszystkim współpracownikom! Bez Twojego wkładu ten projekt nie byłby tym, czym jest dzisiaj.

Licencja

infrastructure-agent-ansible jest licencjonowany na podstawie Licencji Apache 2.0.