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

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

1. 인스턴스 파일을 생성합니다. 이 수집기가 모니터할 SQL Server 인스턴스당 하나의 항목을 추가하거나, 단일 인스턴스만 실행 중인 경우 하나의 항목만 추가하십시오:

   bash

   카피

   $
   cat > ~/mssql-instances.yml << 'EOF'
   $
   instances:
   $
     - host: localhost
   $
       port: 1433
   $
       login_name: newrelic
   $
   EOF

2. 각 인스턴스에 대한 관리자 로그인 및 비밀번호를 포함하여 secrets 파일을 생성하고, 인스턴스 파일의 순서와 일치하도록 인덱싱하십시오. 관리자 로그인은 sysadmin 역할(또는 동등한 역할)의 구성원이어야 합니다:

   bash

   카피

   $
   umask 077
   $
   cat > ~/mssql-secrets.env << 'EOF'
   $
   NR_CLI_MSSQL_ADMIN_USER_1=<YOUR_ADMIN_USERNAME>
   $
   NR_CLI_MSSQL_ADMIN_PASSWORD_1=<YOUR_ADMIN_PASSWORD>
   $
   EOF
   $
   chmod 600 ~/mssql-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-mssql

   Windows (관리자 PowerShell 세션에서 실행):

   [Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql

   카피

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

   변하기 쉬운	설명	기본값
   NR_CLI_MSSQL_CONFIG_PRESET	NRDOT 설정: 1 Basic용 2 고급의 경우	1
   NR_CLI_MSSQL_INSTANCES_FILE	필수 항목입니다. 인스턴스 YAML 파일의 경로입니다.	없음
   NR_CLI_MSSQL_SECRETS_FILE	필수 항목입니다. secrets 파일 경로입니다( KEY=VALUE , 인스턴스당 하나의 관리자 로그인/비밀번호 쌍).	없음

   팁

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

이 메서드는 Windows 수집기 호스트에서만 지원됩니다. SQL 로그인 대신 Windows 인증(integrated security=true)을 사용하며, 단일 수집기에서 하나 이상의 SQL Server 인스턴스를 모니터합니다. 수집기는 하나의 로그온 계정을 사용하는 하나의 Windows 서비스이며 해당 계정으로 모든 인스턴스에 연결되므로, 다중 인스턴스 설치는 항상 나열된 모든 인스턴스에 부여된 하나의 인증 모드와 하나의 Windows ID를 사용합니다.

1. 인스턴스 파일을 생성합니다. 이 수집기에서 모니터할 SQL Server 인스턴스당 하나의 항목을 추가하거나, 단일 인스턴스만 실행하는 경우 하나의 항목만 추가하십시오. host 및 port만 필요합니다(login_name 없음, secrets 파일 없음):

   instances:
     - host: sql01.contoso.com
       port: 1433
     - host: sql02.contoso.com
       port: 1433

   카피

   이를 수집기 호스트의 아무 곳에나 저장하십시오(예: C:\mssql-instances.yml). 명명된 인스턴스의 경우 host\INSTANCE 대신 host 및 해당 정적 TCP 포트를 사용하십시오.

   이 명령을 실행하기 전에 다음을 준비하십시오:

• 1단계의 인스턴스 파일

• Windows 계정을 사용하든 gMSA 계정을 사용하든

• Windows 인증의 경우: 수집기가 SQL Server와 동일한 호스트에서 실행되는지 아니면 다른 호스트에서 실행되는지 여부

• 권한을 부여할 Windows 계정(또는 gMSA 계정) (수집기가 SQL Server와 동일한 호스트에서 실행되는 경우 필요하지 않음)

• 기본 또는 고급 메트릭을 원하는지 여부

  관리자 PowerShell 세션에서 이를 실행하십시오:

  [Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql-winauth

  카피

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

  변하기 쉬운	설명	기본값
  NR_CLI_MSSQL_CONFIG_PRESET	NRDOT 설정: 1 Basic용 2 고급의 경우	1
  NR_CLI_MSSQL_AUTH_MODE	SQL Server 인증: 1 Windows 인증용 2 gMSA의 경우	1
  NR_CLI_MSSQL_WINAUTH_LOCATION	Windows 인증 전용: 1 수집기가 SQL Server와 동일한 호스트에서 실행되는 경우(설치하는 사용자의 ID가 사용되고 서비스가 LocalSystem 상태로 유지되므로 도메인 계정이 필요하지 않음) 2 다른 호스트에서 실행되는 경우	1
  NR_CLI_MSSQL_INSTANCES_FILE	필수 항목입니다. 인스턴스 YAML 파일의 경로입니다(인스턴스당 host / port ).	없음
  NR_CLI_MSSQL_WIN_ACCOUNT	권한을 부여할 Windows 계정, DOMAIN\username . NR_CLI_MSSQL_AUTH_MODE 이(가) 1 이고 NR_CLI_MSSQL_WINAUTH_LOCATION 이(가) 2 인 경우에만 필요하며, gMSA 또는 동일 호스트 흐름의 경우 비워 두십시오.	없음
  NR_CLI_MSSQL_WIN_PASSWORD	해당 Windows 계정의 비밀번호입니다. NR_CLI_MSSQL_AUTH_MODE 이(가) 1 이고 NR_CLI_MSSQL_WINAUTH_LOCATION 이(가) 2 인 경우에만 필요하며, gMSA 또는 동일 호스트 흐름의 경우 비워 둡니다.	없음
  NR_CLI_MSSQL_GMSA_ACCOUNT	gMSA 계정, DOMAIN\gMSAName$ . gMSA 전용이며, Windows 인증의 경우 비워 두십시오.	없음

  팁

  이 수집기에서 두 개 이상의 SQL Server 인스턴스를 모니터하려면 인스턴스 파일에 항목을 더 추가하십시오. 파일의 모든 인스턴스에 대해 하나의 인증 모드와 하나의 Windows ID가 사용되며, 인스턴스당 다른 ID는 지원되지 않습니다. 잘못된 호스트 또는 포트, 중복된 host:port, 또는 버전 검사나 권한 설정에 실패한 인스턴스는 전체 설치를 중단하는 대신 로그된 이유와 함께 건너뜁니다. 동일 호스트 흐름(NR_CLI_MSSQL_WINAUTH_LOCATION 1)은 이 컴퓨터의 인스턴스에만 작동합니다. 다른 호스트 흐름 또는 gMSA를 사용하여 다른 호스트의 인스턴스를 나열하십시오.

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

1. 단일 RDS 인스턴스만 모니터링하는 경우, RDS 엔드포인트를 host(으)로 사용하여 단 하나의 항목만 있는 인스턴스 파일을 생성하십시오:

   bash

   카피

   $
   cat > ~/mssql-instances.yml << 'EOF'
   $
   instances:
   $
     - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
   $
       port: 1433
   $
       login_name: newrelic
   $
   EOF

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

   bash

   카피

   $
   umask 077
   $
   cat > ~/mssql-secrets.env << 'EOF'
   $
   NR_CLI_MSSQL_ADMIN_USER_1=admin
   $
   NR_CLI_MSSQL_ADMIN_PASSWORD_1=YourMasterPassword1
   $
   EOF
   $
   chmod 600 ~/mssql-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-mssql-rds

   Windows (관리자 PowerShell 세션에서 실행):

   [Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql-rds

   카피

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

   변하기 쉬운	설명	기본값
   NR_CLI_MSSQL_CONFIG_PRESET	NRDOT 설정: 1 Basic용 2 고급의 경우	1
   NR_CLI_MSSQL_INSTANCES_FILE	필수 항목입니다. RDS 엔드포인트를 host (으)로 사용하는 인스턴스 YAML 파일의 경로입니다.	없음
   NR_CLI_MSSQL_SECRETS_FILE	필수 항목입니다. secrets 파일 경로입니다( KEY=VALUE , 인스턴스당 하나의 RDS 마스터 사용자 이름/비밀번호 쌍).	없음

   팁

   이 수집기에서 둘 이상의 RDS SQL Server 엔드포인트를 모니터하려면 인스턴스 파일에 항목을 더 추가하고 시크릿 파일에 일치하는 번호가 지정된 자격 증명을 추가하십시오. 검사에 실패한 인스턴스는 전체 설치를 중단하는 대신 로그에 기록된 이유와 함께 건너뜁니다.

이 메서드는 Windows 수집기 호스트에서만 지원되며, RDS 인스턴스가 AWS Managed Microsoft AD 도메인에 이미 가입되어 있어야 합니다. 단일 수집기에서 하나 이상의 RDS SQL Server 엔드포인트를 모니터합니다. 수집기는 하나의 로그온 계정을 사용하는 하나의 Windows 서비스이며 해당 계정으로 모든 엔드포인트에 연결되므로, 다중 인스턴스 설치는 항상 나열된 모든 엔드포인트에 부여된 하나의 인증 모드와 하나의 Windows ID를 사용합니다. 위의 자체 호스팅 메서드와 달리 여기에는 "동일 호스트" 옵션이 없으며, 도메인 계정(또는 gMSA)이 항상 필요합니다.

1. 단일 RDS 인스턴스만 모니터링하는 경우, 각 RDS 엔드포인트를 host(으)로 사용하여 단 하나의 항목만 있는 인스턴스 파일을 생성하십시오:

   instances:
     - host: mydb1.xxxxxxxxxx.us-east-1.rds.amazonaws.com
       port: 1433
     - host: mydb2.xxxxxxxxxx.us-east-1.rds.amazonaws.com
       port: 1433

   카피

   이를 수집기 호스트의 아무 곳에나 저장하십시오(예: C:\mssql-instances.yml).

   이 명령을 실행하기 전에 다음을 준비하십시오:

• 1단계의 인스턴스 파일

• Windows 도메인 계정을 사용하는지 또는 gMSA 계정을 사용하는지 여부

• 권한을 부여할 도메인 계정(또는 gMSA 계정)

• 기본 또는 고급 메트릭을 원하는지 여부

  관리자 PowerShell 세션에서 이를 실행하십시오:

  [Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql-rds-winauth

  카피

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

  변하기 쉬운	설명	기본값
  NR_CLI_MSSQL_CONFIG_PRESET	NRDOT 설정: 1 Basic용 2 고급의 경우	1
  NR_CLI_MSSQL_AUTH_MODE	SQL Server 인증: 1 Windows 도메인 인증용 2 gMSA의 경우	1
  NR_CLI_MSSQL_INSTANCES_FILE	필수 항목입니다. RDS 엔드포인트를 host (으)로 사용하는 인스턴스 YAML 파일의 경로입니다.	없음
  NR_CLI_MSSQL_WIN_ACCOUNT	권한을 부여할 Windows 도메인 계정, DOMAIN\username . Windows 도메인 인증 전용이며, gMSA의 경우 비워 두십시오.	없음
  NR_CLI_MSSQL_WIN_PASSWORD	해당 도메인 계정의 비밀번호입니다. Windows 도메인 인증 전용이며, gMSA의 경우 비워 두십시오.	없음
  NR_CLI_MSSQL_GMSA_ACCOUNT	gMSA 계정, DOMAIN\gMSAName$ . gMSA 전용이며, Windows 도메인 인증의 경우 비워 두십시오.	없음

  팁

  이 수집기에서 두 개 이상의 RDS SQL Server 엔드포인트를 모니터하려면 인스턴스 파일에 항목을 더 추가하십시오. 파일의 모든 엔드포인트에 하나의 인증 모드와 하나의 Windows ID가 사용됩니다. 잘못된 호스트나 포트, 중복된 host:port, 또는 버전 확인이나 권한 설정에 실패한 엔드포인트는 전체 설치를 중단하는 대신 로그된 이유와 함께 건너뜁니다.