CLI를 사용하여 PostgreSQL 모니터링을 위한 NRDOT 설치 및 구성

이 레시피는 단일 수집기에서 하나 이상의 PostgreSQL 인스턴스를 모니터합니다. 단일 호스트/포트/자격 증명 세트를 요청하는 대신, 사용자가 미리 생성한 두 개의 파일을 읽습니다: 모니터할 모든 인스턴스와 각 인스턴스에서 모니터할 데이터베이스를 나열하는 인스턴스 파일(YAML), 그리고 일치하도록 인덱싱된 각각의 수퍼유저 로그인 및 비밀번호가 포함된 시크릿 파일(KEY=VALUE)입니다.

1. 인스턴스 파일을 생성합니다. 이 수집기가 모니터할 PostgreSQL 인스턴스당 하나의 항목을 추가합니다, 단일 인스턴스만 실행 중인 경우에도 여전히 하나의 항목입니다. 각 인스턴스에는 최소 하나의 데이터베이스가 필요합니다: PostgreSQL에는 모든 데이터베이스 모니터 모드가 없습니다:

   bash

   카피

   $
   cat > ~/postgresql-instances.yml << 'EOF'
   $
   instances:
   $
     - host: localhost
   $
       port: 5432
   $
       login_name: newrelic
   $
       databases: [app1, app2]
   $
   EOF

2. 인스턴스 파일의 순서와 일치하도록 인덱싱하여 각 인스턴스에 대한 슈퍼유저 역할(모든 슈퍼유저 역할이 가능하며, 반드시 postgres일 필요는 없습니다) 및 비밀번호로 시크릿 파일을 생성하십시오:

   bash

   카피

   $
   umask 077
   $
   cat > ~/postgresql-secrets.env << 'EOF'
   $
   NR_CLI_POSTGRES_SUPERUSER_USER_1=postgres
   $
   NR_CLI_POSTGRES_SUPERUSER_PASSWORD_1=YourSuperuserPassword1
   $
   EOF
   $
   chmod 600 ~/postgresql-secrets.env

   bash

   카피

   $
   curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-postgresql

   중요

   이 인스톨러는 암호를 사용하여 TCP를 통해 PostgreSQL에 연결하므로, 각 인스턴스의 슈퍼유저에게 암호가 설정되어 있어야 하며 pg_hba.conf은(는) TCP 연결에 대해 암호 기반 호스트 인증(md5 또는 scram-sha-256)을 허용해야 합니다. 새로 설치한 경우 기본적으로 postgres에 암호가 설정되어 있지 않습니다. 먼저 암호를 설정하십시오:

   bash

   카피

   $
   sudo -u postgres psql -c "ALTER USER postgres WITH PASSWORD '<password>';"

   RHEL/CentOS에서 기본 pg_hba.conf은(는) 비밀번호 기반 호스트 인증을 전혀 허용하지 않는 경우가 많습니다. 설치를 실행하기 전에 이를 확인하고 업데이트한 다음 PostgreSQL을 다시 로드하십시오.

   CLI는 다음 변수에 대해 대화형으로 프롬프트를 표시합니다. 비대화형으로 실행하기 위해 환경 변수로 미리 설정할 수도 있습니다.

   변하기 쉬운	설명	기본값
   NR_CLI_POSTGRES_CONFIG_PRESET	NRDOT 설정: 1 기본, 2 고급.	1
   NR_CLI_POSTGRES_INSTANCES_FILE	필수 항목입니다. 인스턴스 YAML 파일 경로입니다.	없음
   NR_CLI_POSTGRES_SECRETS_FILE	필수 항목입니다. 시크릿 파일 경로( KEY=VALUE , 인스턴스당 하나의 슈퍼유저 로그인/비밀번호 쌍).	없음
   NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER	잠금/쓰기 문에 대한 쿼리 계획도 수집하십시오. 각 모니터 데이터베이스에 SECURITY DEFINER 도우미 함수( otel.explain_statement )를 생성하여, DML 액세스 권한을 부여하지 않고 모니터링 사용자 EXPLAIN 에게 실행 권한을 부여합니다. 이것은 PREVIEW 기능입니다. y / N .	n

   팁

   이 수집기에서 두 개 이상의 PostgreSQL 인스턴스를 모니터링하려면 인스턴스 파일에 항목을 더 추가하고 일치하는 번호가 지정된 자격 증명(_2, _3,...)을 secrets 파일에 추가하십시오. 검사에 실패한(또는 나열된 데이터베이스가 없는) 인스턴스는 전체 설치를 중단하는 대신 로그에 기록된 이유와 함께 건너뛰며, 설치는 인스턴스 중 어느 것도 통과하지 못하는 경우에만 완전히 실패합니다.

이 레시피는 자체 호스팅과 동일한 인스턴스 파일/시크릿 파일 패턴을 사용하여 단일 수집기에서 하나 이상의 RDS PostgreSQL 또는 Aurora 엔드포인트를 모니터합니다.

1. RDS 또는 Aurora 엔드포인트를 host(으)로 사용하여 인스턴스 파일을 생성하되, 단일 인스턴스만 모니터링하는 경우 여전히 항목은 하나뿐입니다. 각 인스턴스에는 하나 이상의 데이터베이스가 필요합니다: PostgreSQL에는 모든 데이터베이스 모니터링 모드가 없습니다:

   bash

   카피

   $
   cat > ~/postgresql-instances.yml << 'EOF'
   $
   instances:
   $
     - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
   $
       port: 5432
   $
       login_name: newrelic
   $
       databases: [app1, app2]
   $
   EOF

2. 인스턴스 파일의 순서와 일치하도록 인덱싱하여 각 인스턴스에 대한 RDS 마스터 사용자 이름과 비밀번호로 secrets 파일을 생성하십시오:

   bash

   카피

   $
   umask 077
   $
   cat > ~/postgresql-secrets.env << 'EOF'
   $
   NR_CLI_POSTGRES_ADMIN_USER_1=postgres
   $
   NR_CLI_POSTGRES_ADMIN_PASSWORD_1=YourMasterPassword1
   $
   EOF
   $
   chmod 600 ~/postgresql-secrets.env

   bash

   카피

   $
   curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-postgresql-rds

   CLI는 다음 변수에 대해 대화형으로 프롬프트를 표시합니다. 비대화형으로 실행하기 위해 환경 변수로 미리 설정할 수도 있습니다.

   변하기 쉬운	설명	기본값
   NR_CLI_POSTGRES_CONFIG_PRESET	NRDOT 설정: 1 기본, 2 고급.	1
   NR_CLI_POSTGRES_INSTANCES_FILE	필수 항목입니다. RDS 또는 Aurora 엔드포인트를 host (으)로 사용하는 인스턴스 YAML 파일 경로입니다.	없음
   NR_CLI_POSTGRES_SECRETS_FILE	필수 항목입니다. 시크릿 파일 경로( KEY=VALUE , 인스턴스당 하나의 RDS 마스터 사용자 이름/비밀번호 쌍).	없음
   NR_CLI_POSTGRES_ENABLE_EXPLAIN_HELPER	잠금/쓰기 문에 대한 쿼리 계획도 수집하십시오. 각 모니터 데이터베이스에 SECURITY DEFINER 도우미 함수( otel.explain_statement )를 생성하여, DML 액세스 권한을 부여하지 않고 모니터링 사용자 EXPLAIN 에게 실행 권한을 부여합니다. 이것은 PREVIEW 기능입니다. y / N .	n

   팁

   이 수집기에서 두 개 이상의 RDS PostgreSQL 또는 Aurora 엔드포인트를 모니터하려면, 인스턴스 파일에 항목을 더 추가하고 secrets 파일에 일치하는 번호의 자격 증명을 추가하십시오. 검사에 실패한(또는 나열된 데이터베이스가 없는) 인스턴스는 전체 설치를 중단하는 대신 로그에 기록된 이유와 함께 건너뜁니다.