Amazon Timestream for LiveAnalytics와 유사한 기능을 원하는 경우 Amazon Timestream for InfluxDB를 고려해 보세요. 간소화된 데이터 수집과 실시간 분석을 위한 10밀리초 미만의 쿼리 응답 시간을 제공합니다. [여기](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)에서 자세히 알아보세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Timestream for InfluxDB DB 인스턴스에 연결
DB 인스턴스에 연결하려면 먼저 DB 인스턴스를 생성해야 합니다. 자세한 내용은 [DB 인스턴스 생성](timestream-for-influx-configuring.md#timestream-for-influx-configuring-create-db) 단원을 참조하세요. Amazon Timestream이 DB 인스턴스를 프로비저닝한 후 InfluxDB API, Influx CLI 또는 InfluxDB용 호환 클라이언트나 유틸리티를 사용하여 DB 인스턴스에 연결합니다.
**Topics**
+ [Amazon Timestream for InfluxDB DB 인스턴스에 대한 연결 정보 찾기](#timestream-for-influx-db-connecting-finding-connection-info)
+ [데이터베이스 인증 옵션](#timestream-for-influx-db-connecting-authentication-options)
+ [파라미터 그룹 작업](#timestream-for-influx-parameter-groups)
## Amazon Timestream for InfluxDB DB 인스턴스에 대한 연결 정보 찾기
DB 인스턴스의 연결 정보에는 엔드포인트, 포트, 사용자 이름, 암호 및 유효한 액세스 토큰(연산자, 모든 액세스 토큰 등)이 포함됩니다. 예를 들어 Timestream for InfluxDB DB 인스턴스의 엔드포인트 값이 `c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws`이라고 가정합니다. 이 경우 포트 값은 8,086이고 데이터베이스 사용자는 *admin*입니다. 이 정보를 바탕으로 인스턴스에 액세스하려면 다음을 사용합니다.
+ 인스턴스의 엔드포인트, `c5vasdqn0b-3ksj4dla5nfjhi.timestream-influxdb.us-east-1.on.aws:8086`
+ 인스턴스를 생성할 때 제공된 사용자 이름과 암호 또는 유효한 액세스 토큰
2024년 12월 9일 이전에 생성된 인스턴스는 인스턴스 ID 대신 인스턴스 이름이 포함된 엔드포인트를 갖게 됩니다. 예를 들어 `influxdb1-123456789.us-east-1.timestream-influxdb.amazonaws.com`입니다.
**중요**
DB 인스턴스 응답 객체의 일부로 `influxAuthParametersSecretArn`을 받게 됩니다. 이는 계정의 SecretsManager 시크릿에 대한 ARN을 보유합니다. 이 ARN은 InfluxDB DB 인스턴스가 사용 가능해진 후에만 채워집니다. 이 시크릿은 `CreateDbInstance` 프로세스 중 제공된 influx 인증 파라미터를 포함하며, **읽기 전용** 사본이므로 이 시크릿에 대한 모든 업데이트/수정/삭제는 생성된 DB 인스턴스에 영향을 미치지 않습니다. 이 시크릿을 삭제하더라도, API 응답은 여전히 삭제된 시크릿 ARN을 참조합니다.
엔드포인트는 DB 인스턴스마다 고유하며 포트 및 사용자 값이 다를 수 있습니다. DB 인스턴스에 연결하기 위해 Influx CLI, InfluxDB API 또는 InfluxDB와 호환되는 모든 클라이언트를 사용할 수 있습니다.
DB 인스턴스의 연결 정보를 찾으려면 AWS 관리 콘솔을 사용합니다. AWS 명령줄 인터페이스(AWS CLI) `describe-db-instances` 명령 또는 Timestream for InfluxDB API `GetDBInstance` 작업을 사용할 수도 있습니다.
**사용 AWS Management Console**
1. 에 로그인 AWS Management Console 하고 [Amazon Timestream 콘솔](https://console.aws.amazon.com/timestream/)을 엽니다.
1. 탐색 창에서 **InfluxDB 데이터베이스**를 선택하여 DB 인스턴스 목록을 표시합니다.
1. DB 인스턴스의 이름을 선택하여 세부 정보를 표시합니다.
1. **요약** 섹션에서 엔드포인트를 복사합니다. 또한 포트 번호를 적어 둡니다. DB 인스턴스에 연결하려면 엔드포인트와 포트 번호 모두 필요합니다.
사용자 이름과 암호 정보를 찾아야 하는 경우 **구성 세부 정보** 탭을 선택하고 `influxAuthParametersSecretArn`을 선택하여 Secrets Manager에 액세스합니다.
**CLI 사용**
+ 를 사용하여 InfluxDB DB 인스턴스의 연결 정보를 찾으려면 `get-db-instance` 명령을 AWS CLI호출합니다. 직접 호출에서 DB 인스턴스 ID, 엔드포인트, 포트 및 influxAuthParametersSecretArn을 쿼리합니다.
Linux, macOS, Unix의 경우:
```
aws timestream-influxdb get-db-instance --identifier id \
--query "[name,endpoint,influxAuthParametersSecretArn]"
```
Windows의 경우:
```
aws timestream-influxdb get-db-instance --identifier id ^
--query "[name,endpoint,influxAuthParametersSecretArn]"
```
다음과 유사하게 출력되어야 합니다. 사용자 이름 정보에 액세스하려면 `InfluxAuthParameterSecret`을 확인해야 합니다.
```
[
[
"mydb",
"mydbid-123456789012.timestream-influxdb.us-east-1.on.aws",
8086,
]
]
```
### 액세스 토큰 생성
이 정보로 인스턴스에 연결하여 액세스 토큰을 검색하거나 생성할 수 있습니다. 이를 달성하는 데는 몇 가지 방법이 있습니다.
**CLI 사용**
1. 아직 하지 않았으면 [influx CLI](https://docs.influxdata.com/influxdb/v2/tools/influx-cli/)를 다운로드하여 설치하고 구성합니다.
1. influx CLI 구성을 설정할 때 `--username-password`를 사용하여 인증합니다.
```
influx config create --config-name YOUR_CONFIG_NAME --host-url "https://yourinstanceid-accountidentifier.timestream-influxdb.us-east-1.on.aws:8086" --org yourorg --username-password admin --active
```
1. [influx auth create](https://docs.influxdata.com/influxdb/v2/reference/cli/influx/auth/create/) 명령을 사용하여 연산자 토큰을 다시 생성합니다. 이 프로세스를 수행하면 기존 연산자 토큰이 무효화된다는 점에 유의하세요.
```
influx auth create --org kronos --operator
```
1. 연산자 토큰이 있으면 [influx auth list](https://docs.influxdata.com/influxdb/v2/reference/cli/influx/auth/list) 명령을 사용하여 토큰을 모두 볼 수 있습니다. [influx auth create](https://docs.influxdata.com/influxdb/v2/reference/cli/influx/auth/create/) 명령을 사용하여 모든 액세스 토큰을 생성할 수 있습니다.
**중요**
먼저 이 단계를 수행하여 연산자 토큰을 받아야 합니다. 그런 다음 InfluxDB API 또는 CLI를 사용하여 새 토큰을 생성할 수 있습니다.
**InfluxDB UI 사용**
1. 생성된 엔드포인트를 사용해서 Timestream for InfluxDB 인스턴스로 이동하여 로그인하고 InfluxDB UI에 액세스합니다. InfluxDB DB 인스턴스를 생성하는 데 사용된 사용자 이름과 암호를 사용해야 합니다. `CreateDbInstance`의 응답 객체에 지정된 `influxAuthParametersSecretArn`에서 이 정보를 검색할 수 있습니다.
또는 Amazon Timestream for InfluxDB 콘솔에서 InfluxDB UI를 열 수 있습니다.
1. 에 로그인 AWS Management Console 하고 Timestream for InfluxDB 콘솔을 엽니다. [https://console.aws.amazon.com/timestream/](https://console.aws.amazon.com/timestream/)
1. Amazon Timestream for InfluxDB 콘솔의 오른쪽 상단에서 DB 인스턴스를 생성한 AWS 리전을 선택합니다.
1. **데이터베이스** 목록에서 InfluxDB 인스턴스의 이름을 선택하면 세부 정보가 표시됩니다. 오른쪽 상단 모서리에서 **InfluxDB UI**를 선택합니다.
1. InfluxDB UI에 로그인한 후 왼쪽 탐색 모음을 사용하여 **데이터 로드**로 이동한 다음 **API 토큰**으로 이동합니다.
1. **API 토큰 생성**을 선택하고 **모든 액세스 API 토큰**을 선택합니다.
1. API 토큰에 대한 설명을 입력하고 **저장**을 선택합니다.
1. 생성된 토큰을 복사하여 안전하게 보관합니다.
**중요**
InfluxDB UI에서 토큰을 생성할 때 새로 생성된 토큰은 한 번만 표시됩니다. 반드시 복사해 두세요. 그렇지 않으면 다시 생성해야 합니다.
**InfluxDB API 사용**
+ POST 요청 방법을 사용하여 InfluxDB API `/api/v2/authorizations` 엔드포인트에 요청을 보냅니다.
요청에 다음 내용을 포함합니다.
1. 헤더:
1. 권한 부여: 토큰
1. Content-Type: application/json
1. 요청 본문: 다음 속성을 포함하는 JSON 본문:
1. 상태: ‘활성’
1. 설명: API 토큰 설명
1. orgID: InfluxDB 조직 ID
1. 권한: 각 객체가 InfluxDB 리소스 유형이나 특정 리소스에 대한 권한을 나타내는 객체의 배열입니다. 각 권한은 다음 속성을 포함합니다.
1. 작업: ‘읽기’ 또는 ‘쓰기’
1. 리소스: 권한을 부여할 InfluxDB 리소스를 나타내는 JSON 객체입니다. 각 리소스에는 최소한 orgID: InfluxDB 조직 ID 속성이 포함됩니다.
1. 유형: 리소스 유형. 존재하는 InfluxDB 리소스 유형에 대한 자세한 내용을 보려면 /api/v2/resources 엔드포인트를 사용합니다.
다음 예제에서는 `curl`과 InfluxDB API를 사용하여 모든 액세스 토큰을 생성합니다.
```
export INFLUX_HOST=https://instanceid-123456789.timestream-influxdb.us-east-1.on.aws
export INFLUX_ORG_ID=
export INFLUX_TOKEN=
curl --request POST \
"$INFLUX_HOST/api/v2/authorizations" \
--header "Authorization: Token $INFLUX_TOKEN" \
--header "Content-Type: text/plain; charset=utf-8" \
--data '{
"status": "active",
"description": "All access token for get started tutorial",
"orgID": "'"$INFLUX_ORG_ID"'",
"permissions": [
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "authorizations"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "buckets"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dashboards"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "orgs"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "sources"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "tasks"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "telegrafs"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "users"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "variables"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "scrapers"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "secrets"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "labels"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "views"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "documents"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationRules"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notificationEndpoints"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "checks"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "dbrp"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "notebooks"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "annotations"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "remotes"}},
{"action": "read", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}},
{"action": "write", "resource": {"orgID": "'"$INFLUX_ORG_ID"'", "type": "replications"}}
]
}
'
```
## 데이터베이스 인증 옵션
Amazon Timestream for InfluxDB는 데이터베이스 사용자를 인증하는 다음과 같은 방법을 지원합니다.
+ **암호 인증** – DB 인스턴스가 모든 사용자 계정 관리 작업을 수행합니다. InfluxDB UI, InfluxDB CLI 또는 InfluxDB API를 사용하여 사용자를 생성하고, 암호를 지정하고, 토큰을 관리합니다.
+ **토큰 인증** - DB 인스턴스가 모든 사용자 계정 관리 작업을 수행합니다. InfluxDB CLI와 InfluxDB API를 통해 연산자 토큰을 사용하여 사용자를 생성하고, 암호를 지정하고, 토큰을 관리할 수 있습니다.
### 암호화된 연결
애플리케이션에서 SSL(Secure Socket Layer) 또는 TLS(전송 계층 보안)를 사용하여 DB 인스턴스에 대한 연결을 암호화할 수 있습니다. Kronos 서비스에서 생성하고 관리하는 애플리케이션과 InfluxDB 간의 TLS 핸드셰이크에 필요한 인증서입니다. 인증서가 갱신되면 인스턴스는 사용자의 개입 없이 최신 버전으로 자동 업데이트됩니다.
## 파라미터 그룹 작업
[데이터베이스 파라미터(Database parameters)]에서 데이터베이스 구성 방법을 지정합니다. 예를 들어 데이터베이스 파라미터는 메모리를 비롯하여 데이터베이스에 할당할 리소스의 양을 지정할 수 있습니다.
DB 인스턴스를 파라미터 그룹과 연결하여 데이터베이스 구성을 관리합니다. Amazon Timestream for InfluxDB는 기본 설정으로 파라미터 그룹을 정의합니다. 맞춤형 설정으로 자신만의 파라미터 그룹을 정의할 수 있습니다.
### 파라미터 그룹 개요
DB 파라미터 그룹은 하나 이상의 DB 인스턴스에 적용되는 엔진 구성 값의 컨테이너 역할을 합니다.
**Topics**
+ [기본 및 사용자 지정 파라미터 그룹](#timestream-for-influx-parameter-groups-overview-default-custom-parameter-groups)
+ [DB 파라미터 그룹 생성](#timestream-for-influx-parameter-groups-creating)
+ [정적 및 동적 DB 인스턴스 파라미터](#timestream-for-influx-parameter-groups-static-dynamic-parameters)
+ [지원되는 파라미터 및 파라미터 값](#timestream-for-influx-parameter-groups-overview-supported-parameters)
#### 기본 및 사용자 지정 파라미터 그룹
DB 인스턴스는 DB 파라미터 그룹을 사용합니다. 다음 섹션에서는 DB 인스턴스 파라미터 그룹 구성 및 관리에 대해 설명합니다.
#### DB 파라미터 그룹 생성
AWS Management Console AWS Command Line Interface, 또는 Timestream API를 사용하여 새 DB 파라미터 그룹을 생성할 수 있습니다.
DB 파라미터 그룹 이름에는 다음과 같은 제한이 적용됩니다.
+ 이름은 1\$1255자의 문자, 숫자 또는 하이픈으로 구성되어야 합니다.
+ 기본 파라미터 그룹 이름에는 마침표(예: `default.InfluxDB.2.7`)가 포함될 수 있습니다. 하지만 사용자 지정 파라미터 그룹 이름에는 마침표를 포함할 수 없습니다.
+ 첫 자는 문자여야 합니다.
+ ‘dbpg-’로 시작하는 이름은 사용할 수 없습니다.
+ 이름은 하이픈으로 끝나거나 2개 연속 하이픈을 포함할 수 없습니다.
+ DB 파라미터 그룹을 지정하지 않고 DB 인스턴스를 만드는 경우 DB 인스턴스에서는 기본 InfluxDB 엔진을 사용합니다.
기본 DB 파라미터 그룹의 파라미터 설정은 수정할 수 없습니다. 대신에 다음 작업을 할 수 있습니다.
1. 새 파라미터 그룹을 생성해야 합니다.
1. 원하는 파라미터의 설정을 변경합니다. 파라미터 그룹에서 모든 DB 엔진 파라미터를 수정할 수 있는 것은 아닙니다.
1. 사용자 지정 파라미터 그룹을 사용하려면 DB 인스턴스를 업데이트합니다. DB 인스턴스 업데이트에 대한 자세한 내용은 [DB 인스턴스 업데이트](timestream-for-influx-managing-modifying-db.md) 섹션을 참조하세요.
**참고**
사용자 지정 파라미터 그룹을 사용하도록 DB 인스턴스를 수정하고 DB 인스턴스를 시작하면 Amazon Timestream for InfluxDB는 시작 프로세스의 일부로 DB 인스턴스를 자동으로 재부팅합니다.
현재로서는 사용자 지정 파라미터 그룹을 생성한 후에는 수정할 수 없습니다. 파라미터를 변경해야 하는 경우 새 사용자 지정 파라미터 그룹을 생성하고 이 구성 변경이 필요한 인스턴스에 할당해야 합니다. 기존 DB 인스턴스를 업데이트하여 새로운 매개변수 그룹을 할당하는 경우 항상 즉시 적용되고 인스턴스가 재부팅됩니다.
#### 정적 및 동적 DB 인스턴스 파라미터
InfluxDB DB 인스턴스 파라미터는 항상 정적입니다. 다음과 같이 동작합니다.
고정 파라미터를 변경하고, DB 파라미터 그룹을 저장하고, 인스턴스에 할당하면 인스턴스가 재부팅된 후 파라미터 변경 사항이 자동으로 적용됩니다.
새 DB 파라미터 그룹을 DB 인스턴스와 연결하면 Timestream은 DB 인스턴스가 재부팅된 후에만 수정된 정적 파라미터를 적용합니다. 현재 유일한 옵션은 즉시 적용입니다.
DB 파라미터 그룹 변경에 대한 자세한 내용은 [g26][/g26][g25][/g25] 단원을 참조하세요.
#### 지원되는 파라미터 및 파라미터 값
DB 인스턴스에 지원되는 파라미터를 확인하려면 DB 인스턴스에서 사용하는 DB 파라미터 그룹의 파라미터를 봅니다. 자세한 내용은 [DB 파라미터 그룹의 파라미터 값 보기](#timestream-for-influx-working-with-parameter-groups-viewing) 단원을 참조하십시오.
오픈 소스 버전의 InfluxDB에서 지원하는 모든 파라미터에 대한 자세한 내용은 [InfluxDB 구성 옵션](https://docs.influxdata.com/influxdb/v2/reference/config-options/?t=JSON)을 참조하세요. 현재 다음 InfluxDB 파라미터만 수정할 수 있습니다.
****
| 파라미터 | 설명 | 기본값 | 값 | 유효 범위 | Note |
| --- | --- | --- | --- | --- | --- |
| [flux-log-enabled](https://docs.influxdata.com/influxdb/v2/reference/config-options/?t=JSON) | Flux 쿼리에 대한 상세 로그를 표시하는 옵션을 포함합니다. | FALSE | 부울 | 해당 사항 없음 | |
| [로그 수준](https://docs.influxdata.com/influxdb/v2/reference/config-options/#log-level) | 로그 출력 수준입니다. InfluxDB는 지정된 수준보다 크거나 같은 심각도 수준의 로그 항목을 출력합니다. | info | debug, info, error | 해당 사항 없음 | |
| [no-tasks](https://docs.influxdata.com/influxdb/v2/reference/config-options/#no-tasks) | 태스크 스케줄러를 비활성화합니다. 문제가 있는 태스크로 인해 InfluxDB가 시작되지 않는 경우 이 옵션을 사용하면 태스크를 예약하거나 실행하지 않고 InfluxDB를 시작할 수 있습니다. | FALSE | 부울 | 해당 사항 없음 | |
| [query-concurrency](https://docs.influxdata.com/influxdb/v2/reference/config-options/#query-concurrency) | 동시에 실행할 수 있는 쿼리 수입니다. 0으로 설정하면 동시 쿼리 수에 제한이 없습니다. | 0 | | 0\$1256 | |
| [query-queue-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#query-queue-size) | 실행 대기열에서 허용되는 최대 쿼리 수입니다. 대기열 한도에 도달하면 새로운 쿼리가 거부됩니다. 0으로 설정하면 대기열의 쿼리 수에 제한이 없습니다. | 1,024 | | 해당 사항 없음 | |
| [tracing-type](https://docs.influxdata.com/influxdb/v2/reference/config-options/#tracing-type) | InfluxDB에서 추적을 활성화하고 추적 유형을 지정합니다. 추적은 기본적으로 비활성화됩니다. | "" | log, jaeger | 해당 사항 없음 | |
| [metrics-disabled](https://docs.influxdata.com/influxdb/v2/reference/config-options/#metrics-disabled) | [내부 InfluxDB 지표](https://docs.influxdata.com/influxdb/v2/reference/internals/metrics/)를 노출하는 HTTP /metrics 엔드포인트를 비활성화합니다. | FALSE | | 해당 사항 없음 | |
| [http-idle-timeout](https://docs.influxdata.com/influxdb/v2/reference/config-options/#http-idle-timeout) | 서버가 새로운 요청을 기다리는 동안 설정된 연결을 유지해야 하는 최대 기간입니다. 제한 시간을 설정하지 않으려면 `0`으로 설정하세요. | 3m0s | hours, minutes, seconds, milliseconds 단위로 표시되는 기간입니다. 예시: durationType=minutes,value=10 | 시간:-최솟값: 0-최댓값: 256,205분:-최솟값: 0-최댓값: 15,372,286초:-최솟값: 0-최댓값: 922,337,203밀리초:-최솟값: 0-최댓값: 922,337,203,685 | |
| [http-read-header-timeout](https://docs.influxdata.com/influxdb/v2/reference/config-options/#http-read-header-timeout) | 서버가 새로운 요청에 대해 HTTP 헤더 읽기를 시도해야 하는 최대 기간입니다. 제한 시간을 설정하지 않으려면 `0`으로 설정하세요. | 10s | hours, minutes, seconds, milliseconds 단위로 표시되는 기간입니다. 예시: durationType=minutes,value=10 | 시간:-최솟값: 0-최댓값: 256,205분:-최솟값: 0-최댓값: 15,372,286초:-최솟값: 0-최댓값: 922,337,203밀리초:-최솟값: 0-최댓값: 922,337,203,685 | |
| [http-read-timeout](https://docs.influxdata.com/influxdb/v2/reference/config-options/#http-read-timeout) | 서버가 새로운 요청 전체 읽기를 시도해야 하는 최대 기간입니다. 제한 시간을 설정하지 않으려면 `0`으로 설정하세요. | 0 | hours, minutes, seconds, milliseconds 단위로 표시되는 기간입니다. 예시: durationType=minutes,value=10 | 시간:-최솟값: 0-최댓값: 256,205분:-최솟값: 0-최댓값: 15,372,286초:-최솟값: 0-최댓값: 922,337,203밀리초:-최솟값: 0-최댓값: 922,337,203,685 | |
| [http-write-timeout](https://docs.influxdata.com/influxdb/v2/reference/config-options/#http-write-timeout) | 서버가 쓰기 요청을 처리하고 응답하는 데 소비해야 하는 최대 기간입니다. 제한 시간을 설정하지 않으려면 `0`으로 설정하세요. | 0 | hours, minutes, seconds, milliseconds 단위로 표시되는 기간입니다. 예시: durationType=minutes,value=10 | 시간:-최솟값: 0-최댓값: 256,205분:-최솟값: 0-최댓값: 15,372,286초:-최솟값: 0-최댓값: 922,337,203밀리초:-최솟값: 0-최댓값: 922,337,203,685 | |
| [influxql-max-select-buckets](https://docs.influxdata.com/influxdb/v2/reference/config-options/#influxql-max-select-buckets) | `SELECT` 문이 생성할 수 있는 시간 버킷별 최대 그룹 수입니다. `0`으로 설정하면 버킷 수에 제한이 없습니다. | 0 | Long | 최솟값: 0 최댓값: 9,223,372,036,854,775,807 | |
| [influxql-max-select-point](https://docs.influxdata.com/influxdb/v2/reference/config-options/#influxql-max-select-point) | `SELECT` 문이 처리할 수 있는 최대 포인트 수입니다. `0`으로 설정하면 포인트 수에 제한이 없습니다. InfluxDB는 매초 포인트 수를 확인합니다. 따라서 최댓값을 초과하는 쿼리가 즉시 중단되지 않습니다. | 0 | Long | 최솟값: 0 최댓값: 9,223,372,036,854,775,807 | |
| [influxql-max-select-series](https://docs.influxdata.com/influxdb/v2/reference/config-options/#influxql-max-select-series) | `SELECT` 문이 반환할 수 있는 최대 계열 수입니다. `0`으로 설정하면 계열 수에 제한이 없습니다. | 0 | Long | 최솟값: 0 최댓값: 9,223,372,036,854,775,807 | |
| [pprof-disabled](https://docs.influxdata.com/influxdb/v2/reference/config-options/#pprof-disabled) | `/debug/pprof` HTTP 엔드포인트를 비활성화합니다. 이 엔드포인트는 런타임 프로파일링 데이터를 제공하며 디버깅 시 유용할 수 있습니다. | TRUE | 부울 | 해당 사항 없음 | InfluxDB는 pprof 비활성화를 false 기본적으로 로 설정하지만는 이를 true 기본적으로 로 AWS 설정합니다. |
| [query-initial-memory-bytes](https://docs.influxdata.com/influxdb/v2/reference/config-options/#query-initial-memory-bytes) | 쿼리에 할당된 초기 메모리 바이트 수입니다. | 0 | Long | 최솟값: 0최댓값: query-memory-bytes | |
| [query-max-memory-bytes](https://docs.influxdata.com/influxdb/v2/reference/config-options/#influxql-max-select-series) | 쿼리에 허용되는 최대 총 메모리 바이트 수입니다. | 0 | Long | 최솟값: 0최댓값: 9,223,372,036,854,775,807 | |
| [query-memory-bytes](https://docs.influxdata.com/influxdb/v2/reference/config-options/#query-memory-bytes) | 새로 생성된 사용자 세션의 유효 시간(TTL)을 분 단위로 지정합니다. | 0 | Long | 최솟값: 0최댓값: 2,147,483,647 | query-initial-memory-bytes보다 크거나 같아야 합니다. |
| [session-length](https://docs.influxdata.com/influxdb/v2/reference/config-options/#session-length) | 새로 생성된 사용자 세션의 유효 시간(TTL)을 분 단위로 지정합니다. | 60 | Integer | 최솟값: 0최대: 2,880 | |
| [session-renew-disabled](https://docs.influxdata.com/influxdb/v2/reference/config-options/#session-renew-disabled) | 각 요청에서 사용자의 세션 TTL 자동 연장을 비활성화합니다. 기본적으로 모든 요청은 세션의 만료 시간을 지금부터 5분으로 설정합니다. 비활성화 시 지정된 [세션 길이](https://docs.influxdata.com/influxdb/v2/reference/config-options/#session-length)가 지나면 세션이 만료되며 사용자는 최근에 활동했더라도 로그인 페이지로 리디렉션됩니다. | FALSE | 부울 | 해당 사항 없음 | |
| [storage-cache-max-memory-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-cache-max-memory-size) | 쓰기 거부를 시작하기 전에 샤드의 캐시가 도달할 수 있는 최대 크기(바이트)입니다. | 1,073,741,824 | Long | 최솟값: 0최댓값: 549,755,813,888 | 인스턴스의 총 메모리 용량보다 작아야 합니다.총 메모리 용량의 15% 미만으로 설정하는 것이 좋습니다. |
| [storage-cache-snapshot-memory-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-cache-snapshot-memory-size) | 스토리지 엔진이 캐시 스냅샷을 생성하고 TSM 파일에 써서 사용 가능한 메모리를 늘리는 크기(바이트)입니다. | 26,214,400 | Long | 최솟값: 0최댓값: 549,755,813,888 | storage-cache-max-memory-size보다 작아야 합니다. |
| [storage-cache-snapshot-write-cold-duration](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-cache-snapshot-write-cold-duration) | 샤드가 쓰기 또는 삭제를 수신하지 않은 경우 스토리지 엔진이 캐시 스냅샷을 생성하고 TSM 파일에 쓰는 기간입니다. | 10m0s | hours, minutes, seconds, milliseconds 단위로 표시되는 기간입니다. 예시: durationType=minutes,value=10 | 시간:-최솟값: 0-최댓값: 256,205분:-최솟값: 0-최댓값: 15,372,286초:-최솟값: 0-최댓값: 922,337,203밀리초:-최솟값: 0-최댓값: 922,337,203,685 | |
| [storage-compact-full-write-cold-duration](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-compact-full-write-cold-duration) | 스토리지 엔진이 쓰기 또는 삭제를 수신하지 않은 경우 샤드의 모든 TSM 파일을 압축하는 기간입니다. | 4h0m0s | hours, minutes, seconds, milliseconds 단위로 표시되는 기간입니다. 예시: durationType=minutes,value=10 | 시간:-최솟값: 0-최댓값: 256,205분:-최솟값: 0-최댓값: 15,372,286초:-최솟값: 0-최댓값: 922,337,203밀리초:-최솟값: 0-최댓값: 922,337,203,685 | |
| [storage-compact-throughput-burst](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-compact-throughput-burst) | TSM 압축이 디스크에 쓸 수 있는 속도 제한(초당 바이트)입니다. | 50,331,648 | Long | 최솟값: 0최댓값: 9,223,372,036,854,775,807 | |
| [storage-max-concurrent-compactions](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-max-concurrent-compactions) | 동시에 실행할 수 있는 최대 전체 및 수준 압축 수입니다. 값이 `0`이면 런타임에 `runtime.GOMAXPROCS(0)`의 50%가 사용됩니다. 0보다 큰 임의의 숫자는 압축을 해당 값으로 제한합니다. 캐시 스냅샷 생성에는 이 설정이 적용되지 않습니다. | 0 | Integer | 최솟값: 0최대: 64 | |
| [storage-max-index-log-file-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-max-index-log-file-size) | 인덱스 미리 쓰기 로그(WAL) 파일이 인덱스 파일로 압축되는 크기(바이트)입니다. 크기가 작을수록 로그 파일이 더 빨리 압축되고 쓰기 처리량이 감소하는 대신 힙 사용량이 줄어듭니다. | 1,048,576 | Long | 최솟값: 0최댓값: 9,223,372,036,854,775,807 | |
| [storage-no-validate-field-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-no-validate-field-size) | 수신 쓰기 요청에 대한 필드 크기 검증을 건너뜁니다. | FALSE | 부울 | 해당 사항 없음 | |
| [storage-retention-check-interval](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-retention-check-interval) | 보존 정책 적용 검사 간격입니다. | 30m0s | hours, minutes, seconds, milliseconds 단위로 표시되는 기간입니다. 예시: durationType=minutes,value=10 | 해당 사항 없음 | 시간:-최솟값: 0-최댓값: 256,205분:-최솟값: 0-최댓값: 15,372,286초:-최솟값: 0-최댓값: 922,337,203밀리초:-최솟값: 0-최댓값: 922,337,203,685 |
| [storage-series-file-max-concurrent-snapshot-compactions](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-series-file-max-concurrent-snapshot-compactions) | 데이터베이스의 모든 계열 파티션에서 동시에 실행될 수 있는 최대 스냅샷 압축 수입니다. | 0 | Integer | 최솟값: 0최대: 64 | |
| [storage-series-id-set-cache-size](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-series-id-set-cache-size) | 이전에 계산된 계열 결과를 저장하기 위해 TSI 인덱스에 사용되는 내부 캐시의 크기입니다. 캐시된 결과는 동일한 태그 키/값 조건자를 사용하는 후속 쿼리가 실행될 때 다시 계산할 필요 없이 빠르게 반환됩니다. 이 값을 `0`으로 설정하면 캐시가 비활성화되고 쿼리 성능이 저하될 수 있습니다. | 100 | Long | 최솟값: 0최댓값: 9,223,372,036,854,775,807 | |
| [storage-wal-max-concurrent-writes](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-wal-max-concurrent-writes) | 동시에 시도할 수 있는 WAL 디렉터리에 대한 최대 쓰기 수입니다. | 0 | Integer | 최솟값: 0최댓값: 256 | |
| [storage-wal-max-write-delay](https://docs.influxdata.com/influxdb/v2/reference/config-options/#storage-wal-max-write-delay) | WAL 디렉터리에 대한 최대 동시 활성 쓰기 수가 충족되었을 때 WAL 디렉터리에 대한 쓰기 요청이 대기할 최대 시간입니다. 제한 시간을 비활성화하려면 `0`으로 설정합니다. | 10m | hours, minutes, seconds, milliseconds 단위로 표시되는 기간입니다. 예시: durationType=minutes,value=10 | 시간:-최솟값: 0-최댓값: 256,205분:-최솟값: 0-최댓값: 15,372,286초:-최솟값: 0-최댓값: 922,337,203밀리초:-최솟값: 0-최댓값: 922,337,203,685 | |
| [ui-disabled](https://docs.influxdata.com/influxdb/v2/reference/config-options/#ui-disabled) | InfluxDB 사용자 인터페이스(UI)를 비활성화합니다. UI는 기본적으로 활성화됩니다. | FALSE | 부울 | 해당 사항 없음 | |
파라미터 그룹에 파라미터를 잘못 설정하면 성능 저하나 시스템 불안정 등의 의도하지 않은 부작용이 있을 수 있습니다. 데이터베이스 파라미터를 수정할 때 항상 주의해야 합니다. 파라미터 그룹 변경 내용을 프로덕션 DB 인스턴스에 적용하기 전에 테스트 DB 인스턴스에서 테스트해야 합니다.
### DB 파라미터 그룹 작업
DB 인스턴스는 DB 파라미터 그룹을 사용합니다. 다음 섹션에서는 DB 인스턴스 파라미터 그룹 구성 및 관리에 대해 설명합니다.
**Topics**
+ [DB 파라미터 그룹 생성](#timestream-for-influx-working-with-parameter-groups-creating)
+ [DB 파라미터 그룹과 DB 인스턴스 연결](#timestream-for-influx-working-with-parameter-groups-associating)
+ [DB 파라미터 그룹 나열](#timestream-for-influx-working-with-parameter-groups-listing)
+ [DB 파라미터 그룹의 파라미터 값 보기](#timestream-for-influx-working-with-parameter-groups-viewing)
#### DB 파라미터 그룹 생성
**사용 AWS Management Console**
1. 에 로그인 AWS Management Console 하고 [Amazon Timestream for InfluxDB 콘솔](https://console.aws.amazon.com/timestream/)을 엽니다.
1. 탐색 창에서 **파라미터 그룹**을 선택합니다.
1. [**Create parameter group**]을 선택합니다.
1. **파라미터 그룹 이름** 상자에 새 DB 파라미터 그룹의 이름을 입력합니다.
1. **설명** 상자에 새 DB 파라미터 그룹에 대한 설명을 입력합니다.
1. 수정할 파라미터를 선택하고 원하는 값을 적용합니다. 지원되는 파라미터에 대한 자세한 내용은 [지원되는 파라미터 및 파라미터 값](#timestream-for-influx-parameter-groups-overview-supported-parameters) 섹션을 참조하세요.
1. **Create parameter group**(파라미터 그룹 생성)을 선택합니다.
**사용 AWS Command Line Interface**
+ AWS CLI를 사용하여 DB 파라미터 그룹을 생성하려면 다음 파라미터와 함께 `create-db-parameter-group` 명령을 호출합니다.
```
--db-parameter-group-name
--description
--endpoint_url
--region
--parameters (list) (string)
```
**Example 예제**
각 설정에 대한 자세한 내용은 [DB 인스턴스에 대한 설정](timestream-for-influx-configuring.md#timestream-for-influx-configuring-create-db-settings) 섹션을 참조하세요. 이 예제에서는 기본 엔진 구성을 사용합니다.
```
aws timestream-influxdb create-db-parameter-group
--db-parameter-group-name YOUR_PARAM_GROUP_NAME \
--endpoint-url YOUR_ENDPOINT \
--region YOUR_REGION \
--parameters "InfluxDBv2={logLevel=debug,queryConcurrency=10,metricsDisabled=true}" \" \
--debug
```
#### DB 파라미터 그룹과 DB 인스턴스 연결
사용자 지정 설정을 사용하여 사용자의 DB 파라미터 그룹을 생성할 수 있습니다. AWS Management Console AWS Command Line Interface, 또는 Timestream for InfluxDB API를 사용하여 DB 파라미터 그룹을 DB 인스턴스와 연결할 수 있습니다. DB 인스턴스를 생성하거나 수정할 때 이 작업을 수행할 수 있습니다.
DB 파라미터 그룹 생성에 대한 자세한 내용은 [DB 파라미터 그룹 생성](#timestream-for-influx-working-with-parameter-groups-creating) 단원을 참조하세요. DB 인스턴스 생성에 대한 자세한 내용은 [DB 인스턴스 생성](timestream-for-influx-configuring.md#timestream-for-influx-configuring-create-db) 단원을 참조하십시오. DB 인스턴스 수정에 대한 자세한 내용은 [g70][/g70][g69][/g69] 섹션을 참조하세요.
**참고**
새 DB 파라미터 그룹을 DB 인스턴스와 연결하면 수정된 정적 파라미터는 DB 인스턴스가 재부팅된 후에만 적용됩니다. 현재 즉시 적용만 지원됩니다. Timestream for InfluxDB는 정적 파라미터만 지원합니다.
**사용 AWS Management Console**
1. 에 로그인 AWS Management Console 하고 [Amazon Timestream for InfluxDB 콘솔](https://console.aws.amazon.com/timestream/)을 엽니다.
1. 탐색 창에서 **InfluxDB 데이터베이스**를 선택한 다음 변경하려는 DB 인스턴스를 선택합니다.
1. **업데이트**를 선택합니다. **DB 인스턴스 업데이트** 페이지가 나타납니다.
1. **DB 파라미터 그룹** 설정을 변경합니다.
1. [**Continue**]를 수정 사항을 요약한 내용을 확인합니다.
1. 현재 **즉시 적용**만 지원됩니다. 이 옵션은 DB 인스턴스를 재시작하므로 경우에 따라 중단을 유발할 수 있습니다.
1. 확인 페이지에서 변경 내용을 검토합니다. 변경 내용이 정확할 경우 **DB 인스턴스 업데이트**를 선택하여 변경 내용을 저장하고 적용합니다. 또는 **뒤로**를 선택하여 변경 내용을 편집하거나 **취소**를 선택하여 변경 내용을 취소합니다.
**사용 AWS Command Line Interface**
Linux, macOS, Unix의 경우:
```
aws timestream-influxdb update-db-instance
--identifier YOUR_DB_INSTANCE_ID \
--region YOUR_REGION \
--db-parameter-group-identifier YOUR_PARAM_GROUP_ID \
--log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"
```
Windows의 경우:
```
aws timestream-influxdb update-db-instance
--identifier YOUR_DB_INSTANCE_ID ^
--region YOUR_REGION ^
--db-parameter-group-identifier YOUR_PARAM_GROUP_ID ^
--log-delivery-configuration "{\"s3Configuration\": {\"bucketName\": \"${LOGGING_BUCKET}\", \"enabled\": false }}"
```
#### DB 파라미터 그룹 나열
AWS 계정에 대해 생성한 DB 파라미터 그룹을 나열할 수 있습니다.
**사용 AWS Management Console**
1. 에 로그인 AWS Management Console 하고 [Amazon Timestream for InfluxDB 콘솔](https://console.aws.amazon.com/timestream/)을 엽니다.
1. 탐색 창에서 **파라미터 그룹**을 선택합니다.
1. DB 파라미터 그룹이 목록에 나타납니다.
**사용 AWS Command Line Interface**
AWS 계정의 AWS Command Line Interface 모든 DB 파라미터 그룹을 나열하려면 `list-db-parameter-groups` 명령을 사용합니다.
```
aws timestream-influxdb list-db-parameter-groups --region region
```
AWS 계정의 특정 DB 파라미터 그룹을 반환하려면 `get-db-parameter-group` 명령을 사용합니다 AWS Command Line Interface .
```
aws timestream-influxdb get-db-parameter-group --region region --identifier identifier
```
#### DB 파라미터 그룹의 파라미터 값 보기
DB 파라미터 그룹의 모든 파라미터와 해당 값 목록을 가져올 수 있습니다.
**사용 AWS Management Console**
1. 에 로그인 AWS Management Console 하고 [Amazon Timestream for InfluxDB 콘솔](https://console.aws.amazon.com/timestream/)을 엽니다.
1. 탐색 창에서 **파라미터 그룹**을 선택합니다.
1. DB 파라미터 그룹이 목록에 나타납니다.
1. 파라미터 그룹의 이름을 선택하여 파라미터 목록을 봅니다.
**사용 AWS Command Line Interface**
DB 파라미터 그룹의 파라미터 값을 보려면 명령을 사용합니다 AWS Command Line Interface `get-db-parameter-group`. *parameter-group-identifier*를 사용자의 정보로 바꿉니다.
```
get-db-parameter-group --identifier parameter-group-identifier
```
**API 사용**
DB 파라미터 그룹의 파라미터 값을 보려면 Timestream API `GetDbParameterGroup` 명령을 사용합니다. *parameter-group-identifier*를 사용자의 정보로 바꿉니다.
```
GetDbParameterGroup parameter-group-identifier
```