Qlik 데이터 게이트웨이 - 직접 액세스 구성 및 문제 해결

이 항목에서는 직접 액세스 게이트웨이를 구성하고 문제를 해결하기 위해 수행할 수 있는 다양한 작업에 대해 설명합니다.

이 항목에서 설명하는 모든 구성 옵션은 직접 액세스 게이트웨이 공개 API를 통해서도 수행할 수 있습니다. 자세한 내용은 https://qlik.dev/apis/rest/direct-access-agents/를 참조하십시오.

Qlik Cloud 테넌트에서 직접 액세스 게이트웨이 구성

직접 액세스 게이트웨이 기본 설정은 대부분의 환경에 적합하지만 성능을 개선하거나 문제를 해결(로깅 설정을 통해)하거나 다양한 연결 문제를 극복하려면 기본값을 재정의해야 할 수도 있습니다.

Qlik Cloud에서 직접 액세스 게이트웨이를 구성하는 기능은 1.7.2 이상에서 지원되지만 전체 구성 옵션의 이점을 얻으려면 최신 버전으로 업그레이드하는 것이 좋습니다.
대부분의 직접 액세스 게이트웨이 설정은 Qlik Cloud 관리 활동 센터에서 구성할 수 있지만, 일부 설정은 직접 액세스 게이트웨이 컴퓨터에서 직접 구성 파일을 편집해야만 변경할 수 있습니다.

Qlik Cloud의 설정을 편집하려면 다음 권한 중 하나가 필요합니다.

테넌트 관리자 및 게이트웨이 공간 소유자
게이트웨이 공간에서 데이터를 소비할 수 있음이 있는 테넌트 구성원

게이트웨이 설정을 열려면:

Qlik Cloud 테넌트에서 관리 > 데이터 게이트웨이로 이동하여 직접 액세스 게이트웨이를 찾습니다.
행 끝에 있는 을 클릭하고 게이트웨이 설정을 선택합니다.

<이름>에 대한 게이트웨이 설정 대화 상자가 열립니다.

설정은 일반 설정(아래)과 커넥터 설정으로 구분됩니다. 설정을 변경하려면 직접 액세스 게이트웨이 서비스를 다시 시작해야 할 수도 있습니다.

일반 설정

이러한 설정은 어떤 커넥터를 사용하든 직접 액세스 게이트웨이의 일반적인 기능과 관련이 있습니다.

에이전트 ID

직접 액세스 게이트웨이 공개 API와 함께 사용할 에이전트 ID.

커넥터 에이전트 포트

커넥터 에이전트에 연결할 때 사용할 포트. 이 설정은 변경할 수 없습니다.

커넥터 에이전트 상태 실패 임계값

직접 액세스 게이트웨이 구성 요소에 대한 정기적 상태 확인이 수행됩니다. 상태 확인은 초기에는 실패하다가 나중에 성공하는 경우가 있습니다. 지정된 임계값을 초과한 후에도 상태 확인이 계속 실패하면 직접 액세스 게이트웨이 서비스가 다시 시작됩니다. Qlik 지원 센터에서 요청한 경우에만 이 설정을 변경해야 합니다.

로드 요청 제한 시간

네트워크 중단이 발생하면 다음 오류와 함께 다시 로드가 실패할 수 있습니다.

Connector error: The session does not exist (DirectAccess-1509)

Connector error: The stream session expired for the load data request (DirectAccess-1012)

위의 오류가 자주 발생하는 경우, 제한 시간을 5~10분으로 늘려보십시오.

커넥터 에이전트 로깅 수준

문제 해결을 위해 커넥터 에이전트 구성 요소의 로깅 수준을 변경해야 할 수도 있습니다. Qlik 지원 센터에서 요청한 경우에만 이 설정을 변경해야 합니다.

커넥터 에이전트 로깅 옵션

특정 커넥터 에이전트 구성 요소의 문제를 해결하려면 해당 로그 파일을 선택해야 할 수도 있습니다. Qlik 지원 센터에서 요청한 경우에만 이 설정을 변경해야 합니다.

캐시된 데이터 청크에 대한 메모리

각각의 다시 로드 작업에 대해 직접 액세스 게이트웨이는 메모리에 데이터 청크를 캐시하고 이를 디스크로 오프로드할 수 있습니다(캐싱에 할당된 크기를 초과하는 경우). 이 기능은 자동 복구를 사용하지 않고 4025, 4020, 4021 오류가 자주 발생하는 경우에 특히 유용합니다. 지정된 threshold에 도달하면 게이트웨이는 다음 암호화된 청크를 직접 액세스 게이트웨이 컴퓨터의 디스크로 오프로드합니다.

청크 복구 기간 임계값

이는 청크 복구 기간에 대한 임계값(분)입니다. 복구 기간 threshold에 도달할 때까지 다시 로드가 재개되지 않으면 적절한 메시지와 함께 실패합니다.

이 옵션은 긴 복구 후 3시간 제한을 초과할 수 있는 다시 로드에 유용합니다. 예를 들어, 데이터베이스에서 데이터를 검색하는 데 90분이 걸리지만 다시 로드가 시작되자마자 청크 중 하나가 손상되었다고 가정해 보겠습니다. 이 경우, 모든 청크는 캐시에 저장되고 캐시에서 전송됩니다. 이러한 시나리오에서는 전체 다시 로드 프로세스(캐시에 저장 + 실제 다시 로드)를 완료하는 데 3시간이 걸릴 수 있습니다.

DCaaS 포트

DCaaS에 연결할 때 사용할 포트. 이 설정은 변경할 수 없습니다.

DCaaS 로깅 수준

문제 해결을 위해 DCaaS 로그의 로깅 수준을 변경해야 할 수도 있습니다. Qlik 지원 센터에서 요청한 경우에만 이 설정을 변경해야 합니다.

커넥터 설정

커넥터 설정을 변경하려면 왼쪽에서 커넥터 유형을 선택한 다음 필요에 따라 설정을 변경합니다.

포트

데이터 소스에 연결할 때 사용할 포트. 이 설정은 변경할 수 없습니다.

로깅 수준

문제 해결을 위해 커넥터 로그의 로깅 수준을 변경해야 할 수도 있습니다. Qlik 지원 센터에서 요청한 경우에만 이 설정을 변경해야 합니다.

프로세스 격리

직접 액세스 게이트웨이 1.6.1 이상이 필요합니다.

프로세스 격리를 통해 직접 액세스 게이트웨이 서버 운영 체제에 액세스할 수 있는 관리자는 커넥터 유형별로 다시 로드 및/또는 메타데이터 명령에 사용할 수 있는 프로세스 수를 제어할 수 있습니다. 여러 커넥터 프로세스에 걸쳐 다시 로드 및/또는 메타데이터 명령을 분산하면 각 커넥터 프로세스에서 동시에 실행되는 다시 로드/또는 메타데이터 명령 수가 줄어들어 격리 수준이 높아집니다. 결과적으로 커넥터 충돌이 발생한 경우 전반적인 직접 액세스 게이트웨이 안정성이 향상될 수 있습니다.

새로 설치하면 프로세스 격리가 기본적으로 활성화됩니다. 각 커넥터 유형에 대한 동시 다시 로드/메타데이터 명령의 기본 수는 9입니다. 아래 동시 다시 로드/명령 프로세스 수에 설명된 대로 기본값을 재정의할 수 있습니다.

다음 옵션을 사용할 수 있습니다.

비활성화됨: Qlik 지원 센터에서는 문제 해결을 위해 프로세스 격리를 비활성화하도록 요청할 수 있습니다.
메타데이터: 메타데이터 명령에 대해서만 프로세스 격리를 활성화합니다. 예를 들어, 멀티스레딩을 지원하지 않는 ODBC 드라이버를 사용하지만 메타데이터 명령을 동시에 실행하려는(주로 미리 보기 목적) 고객에게 유용할 수 있습니다.

정보 메모직접 액세스 게이트웨이 1.7.9부터 지원됩니다.
다시 로드(기본값): 다시 로드 명령에 대해서만 프로세스 격리를 활성화합니다.
모두: 다시 로드 및 메타데이터 명령 모두에 대해 프로세스 격리를 활성화합니다.

정보 메모직접 액세스 게이트웨이 1.7.9부터 지원됩니다.

동시 다시 로드/명령 프로세스 수

명령 프로세스를 포함하여 커넥터에 할당된 동시 다시 로드/명령 프로세스의 수입니다. 따라서 예를 들어 값 30은 최대 29개의 동시 다시 로드/명령을 의미합니다. 이 설정은 프로세스 격리가 활성화된 경우에만 적용됩니다.

직접 액세스 게이트웨이 버전 1.6.7부터 다른 설정을 변경하지 않고도 이 값이 10을 초과할 수 있습니다. 특정 커넥터 유형에 대한 다시 로드를 완전히 분리하려면(즉, 커넥터 프로세스당 한 번만 다시 로드) 이 값을 최소 30으로 설정해야 하지만 워크로드에 따라서는 최대 60까지 설정해야 할 수도 있습니다.

세션 수명 다시 로드

ODBC(via 직접 액세스 게이트웨이) 커넥터에만 해당됩니다.

직접 액세스 게이트웨이 및 Qlik Cloud 간의 연결이 20초 이상 유휴 상태인 경우 다음 오류와 함께 다시 로드 작업이 실패할 수 있습니다.

Invalid object name '#<TempTableName>' (indicating that the 직접 액세스 게이트웨이 temp tables are unavailable).

기본 세션 수명은 20초이지만, 이 오류가 자주 발생하는 경우 필요에 따라 세션 수명을 연장할 수 있습니다.

언로드할 테이블의 최대 개수

ODBC(via 직접 액세스 게이트웨이) 커넥터에만 해당됩니다.
직접 액세스 게이트웨이 1.7.1 이상이 필요합니다.

기본적으로 최대 10,000개의 테이블이 데이터베이스에서 검색됩니다. 데이터베이스에 10,000개가 넘는 테이블이 있는 경우 기본값을 재정의할 수 있습니다.

REST 커넥터를 사용하여 직접 액세스 게이트웨이가 액세스할 수 있는 URL 제한

REST 커넥터를 사용하여 액세스할 수 있는 특정 URL이나 URL 경로에 대한 액세스를 제한할 수 있습니다.

URL 추가, 편집 또는 삭제와 같은 변경 내용은 직접 액세스 게이트웨이 서비스를 다시 시작한 후에만 적용됩니다.

특정 URL에 대한 액세스를 제한하려면 허용된 URL 필드에 URL을 입력하고 추가를 클릭합니다. URL 경로에 대한 액세스를 제한하려면 동일한 작업을 수행하지만 URL에 별표(*)를 추가합니다. 필요에 따라 반복합니다.

예

다음 예에서 허용된 URL 목록에는 두 개의 항목이 포함되어 있습니다.

첫 번째 항목은 https://mypublicrestservice.com/restricted/source에만 액세스할 수 있습니다.
두 번째 항목은 https://mypublicrestservice.com/open 및 https://mypublicrestservice.com/open/shared와 같은 그 아래의 모든 경로에 대한 액세스를 허용합니다.

URL 편집 또는 삭제

URL을 편집하려면 행 끝에 있는 버튼을 클릭하고 원하는 대로 URL을 편집합니다. 그런 다음 을 클릭하여 변경 내용을 저장하거나 을 클릭하여 취소합니다.

URL을 삭제하려면 행 끝에 있는 버튼을 클릭합니다.

또한 REST 연결 만들기 (영어로만 제공)를 참조하십시오.

파일 커넥터를 사용하여 직접 액세스 게이트웨이가 액세스할 수 있는 경로 목록 제한

파일 커넥터를 사용하여 액세스할 수 있는 경로에 대한 액세스를 제한할 수 있습니다. 지정된 경로에 대한 액세스를 추가로 제한하기 위해 경로에 하나 이상의 공간을 넣을 수도 있습니다.

직접 액세스 게이트웨이 1.7.6부터 쌍으로 된 공간이 지원됩니다.
직접 액세스 게이트웨이 1.7.4 또는 1.7.5를 사용하는 경우 경로나 공간을 추가, 편집 또는 삭제하는 등의 변경 내용은 직접 액세스 게이트웨이 서비스를 다시 시작한 후에만 적용됩니다.
데이터를 소비할 수 있음 역할 이상(편집할 수 있음, 응용 프로그램에서 데이터 편집할 수 있음, 관리할 수 있음)이 있는 사용자만 경로에 액세스할 수 있습니다.
표준 DOS 경로와 UNC 경로를 포함하여 모든 Windows 파일 시스템과 네트워크 드라이브가 지원됩니다.

특정 경로에 대한 액세스를 제한하려면 파일 경로 필드에 경로를 입력하고 추가를 클릭합니다. 필요에 따라 반복합니다.

경로와 공간을 쌍으로 만들려면 경로를 추가한 후 행 끝에 있는 버튼을 클릭하고 쌍으로 된 공간 열의 드롭다운 목록에서 하나 이상의 공간을 선택합니다. 경로가 공백과 함께 사용되는 경우, 공백 중 하나 이상에 속하는 사용자만 지정된 경로에 액세스할 수 있습니다. 지정된 공간의 구성원은 자신이 속한 모든 공간(명시적으로 정의되지 않은 경우에도)에서 경로에 액세스할 수 있으며, 여기에는 개인 공간도 포함됩니다.

예

다음 예에서 파일 경로 목록에는 두 개의 항목이 포함되어 있습니다.

첫 번째 항목은 필요한 역할을 가진 모든 사용자가 C:\mypath\source.에 액세스할 수 있도록 허용합니다.
두 번째 항목은 mosheSharedSpace 공간의 구성원만 C:\restricted에 액세스하도록 허용합니다.

항목 편집 또는 삭제

항목을 편집하려면 행 끝에 있는 버튼을 클릭하고 원하는 대로 항목을 편집합니다. 그런 다음 을 클릭하여 변경 내용을 저장하거나 을 클릭하여 변경 내용을 되돌립니다.

항목을 삭제하려면 행 끝에 있는 버튼을 클릭합니다.

참조: 파일(직접 액세스 게이트웨이를 통해) (영어로만 제공).

설정 변경 후 직접 액세스 게이트웨이 다시 시작

일부 설정은 직접 액세스 게이트웨이 서비스를 다시 시작한 후에만 적용됩니다. 이런 경우 설정을 저장할 때 서비스를 다시 시작하라는 메시지가 표시됩니다. 활성화된 다시 로드가 있는 경우, 다시 로드가 완료될 때까지 서비스를 다시 시작할 수 없습니다. 활성화된 다시 로드가 없는 경우 다음과 같이 언제든지 서비스를 다시 시작할 수 있습니다.

Qlik Cloud 테넌트에서 관리 > 데이터 게이트웨이로 이동하여 직접 액세스 게이트웨이를 찾습니다.
행 끝에 있는 을 클릭하고 서비스 다시 시작을 선택합니다.

서비스 시작, 중지 또는 다시 시작에 설명된 대로 직접 액세스 게이트웨이 컴퓨터에서 직접 서비스를 다시 시작할 수도 있습니다.

직접 액세스 게이트웨이 컴퓨터에서 직접 직접 액세스 게이트웨이 구성

대부분의 직접 액세스 게이트웨이 설정은 Qlik Cloud에서 구성할 수 있지만 일부 설정은 직접 액세스 게이트웨이 컴퓨터에서 직접 구성 파일을 편집하여만 변경할 수 있습니다.

기본 청크 캐시 디렉터리 재정의

직접 액세스 게이트웨이 1.7.1 이상이 필요합니다.

각각의 다시 로드 작업에 대해 직접 액세스 게이트웨이는 메모리에 데이터 청크를 캐시하고 이를 디스크로 오프로드할 수 있습니다(캐싱에 할당된 크기를 초과하는 경우). 시스템 드라이브에 충분한 디스크 공간이 없으면 기본 청크 캐시 디렉터리(C:\ProgramData\Qlik\Gateway\tmp)를 재정의할 수 있습니다.

안정성을 보장하고 성능을 최적화하려면 로컬 경로만 사용하는 것이 가장 좋습니다.

수행할 작업:

텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다.
OVERRIDE_CHUNKS_CACHE_DIR 속성을 찾아 원하는 디렉터리로 설정합니다.

예:

OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp

정보 메모경로를 따옴표로 묶지 마십시오.
configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

관련 항목: 캐시된 데이터 청크에 대한 메모리

ODBC(직접 액세스 게이트웨이를 통해) 커넥터를 사용하여 작업할 때 기본 Qlik Cloud 데이터 유형 재정의

직접 액세스 게이트웨이 1.7.1 이상이 필요합니다.

공급업체 ODBC 드라이버가 소스 데이터 유형을 처리하는 데 문제가 있어 다시 로드하는 동안 오류가 발생하거나 잘못된 데이터가 Qlik Cloud에 로드되는 경우가 있습니다. 이러한 경우 Qlik Cloud 데이터 유형 또는 해당 사양(예: 배율 또는 정밀도)을 재정의할 수 있습니다.

많은 문제는 QlikDataType을 String로 변경하면 간단히 해결할 수 있지만, 그렇게 할 수 없는 경우 소스 데이터 유형을 매핑할 수 있는 Qlik Cloud 데이터 유형에 대한 지침을 받으려면 Qlik 지원 센터에 문의하는 것이 좋습니다.

수행할 작업:

텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\custom_type_mappings.json을 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다. 이 파일에는 Qlik Cloud 데이터 유형에 대한 예 소스가 포함되어 있습니다.
문제가 있는 데이터 유형을 원하는 Qlik Cloud 데이터 유형에 매핑하는 섹션을 추가합니다.

다음 예(custom_type_mappings.json 파일에 포함됨)에서 고객은 Qlik Cloud DateTime 데이터 유형의 크기를 27로 변경해야 합니다.

예:
```
{
"Identifier": "Amazon Athena ODBC (x64)",
"NativeDataType": "timestamp with time zone",
"QlikDataType": "DateTime",
"Size": 27,
"IsBit": false
}
```
custom_type_mappings.json 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
데이터를 다시 로드합니다.

직접 액세스 게이트웨이를 Qlik Cloud에 다시 연결하도록 강제합니다.

기본적으로 직접 액세스 게이트웨이가 Qlik Cloud에서 연결이 끊어지면 45초 후에 다시 연결됩니다. 상당히 오랜 시간이 걸리는 경우 게이트웨이를 더 빨리 강제로 재연결할 수 있습니다.

수행할 작업:

텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다. 이 파일에는 Qlik Cloud 데이터 유형에 대한 예 소스가 포함되어 있습니다.
파일의 시작 부분에 있는 # Connector Agent 섹션에 AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds>를 추가합니다.

예:

AGENT_PONG_TIMEOUT_SECONDS=30

정보 메모최소 시간은 30초입니다.
configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

비동기적으로 로드 데이터 요청 수행

직접 액세스 게이트웨이 1.7.5 이상이 필요합니다.

에이전트에서 비동기적으로 데이터 로드 요청을 수행하면 클라우드 서비스가 에이전트의 응답을 기다리는 데 필요한 시간이 크게 단축됩니다.

비동기 로드 데이터 요청을 활성화하려면:

텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다.
파일에 다음 줄이 아직 존재하지 않는 경우 추가합니다:

OPTIONAL_CAPABILITIES=AsyncLoadDataRequest

OPTIONAL_CAPABILITIES=가 다른 매개변수(예: AsyncLoadSlotRequest)와 함께 이미 존재하는 경우, 공백 없이 쉼표로 구분하여 기존 매개변수에 추가합니다.

예:

OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest,AsyncLoadDataRequest
configuration.properties 파일을 저장합니다.

변경 내용은 다음 다시 로드 시 적용되므로 직접 액세스 게이트웨이 서비스를 다시 시작할 필요가 없습니다. 모든 변경 내용은 connector-agent_logs_[date].txt 파일에 기록됩니다.

비동기 데이터 로드 요청을 비활성화하려면:

텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다.
OPTIONAL_CAPABILITIES=None를 설정하거나, 다른 OPTIONAL_CAPABILITIES 매개변수가 있는 경우 AsyncLoadDataRequest를 단순히 삭제합니다.
configuration.properties 파일을 저장합니다.

로드 슬롯 비동기적으로 요청

직접 액세스 게이트웨이 1.7.7 이상 필요.

로드 슬롯을 비동기적으로 요청하면 Qlik Cloud로 리로드 데이터 WebSocket을 생성하는 동안 직접 액세스 게이트웨이로의 임시 명령 파이프 정체를 완화할 수 있습니다. 이는 상당한 수의 동시 리로드를 수행할 때 유용할 수 있습니다.

You should only enable this capability if instructed by Qlik Support.

비동기 로드 슬롯 요청을 활성화하려면:

텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다.
Add the following line to the file if it does not already exist:

OPTIONAL_CAPABILITIES=AsyncLoadSlotRequest

If OPTIONAL_CAPABILITIES= already exists with another parameter (AsyncLoadDataRequest, for example), simply append it to the existing parameter, separated by a comma without a space:

예:

OPTIONAL_CAPABILITIES=AsyncLoadDataRequest,AsyncLoadSlotRequest
configuration.properties 파일을 저장합니다.

비동기 로드 슬롯 요청을 비활성화하려면:

텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다.
OPTIONAL_CAPABILITIES=None를 설정하거나, 다른 OPTIONAL_CAPABILITIES 매개변수가 있는 경우 AsyncLoadSlotRequest를 단순히 삭제합니다.
configuration.properties 파일을 저장합니다.

커넥터 시작 구성

커넥터 시작을 위한 시간 초과 값과 시도 횟수를 늘릴 수 있습니다. 상당한 수의 동시 재로드를 수행할 때 유용할 수 있습니다. 이러한 매개변수를 늘리면 직접 액세스 게이트웨이에게 실패로 종료되어 다시 시작해야 하기 전에 커넥터를 실행할 더 많은 시간과 시도 횟수를 제공합니다.

이 기능을 Qlik 지원에서 지시하는 경우에만 활성화해야 합니다.

직접 액세스 게이트웨이 1.7.7 이상이 필요합니다.

커넥터 시작 매개변수를 조정하려면:

텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다.
다음 줄을 파일에 추가합니다:

# CONNECTOR STARTUP TIMEOUT between 30 and 120 seconds

CONNECTOR_STARTUP_TIMEOUT_SECONDS=your-value

# CONNECTOR STARTUP MAX ATTEMPTS between 1 and 5

CONNECTOR_STARTUP_MAX_ATTEMPTS=your-value

정보 메모 명령 파이프 정체를 방지하려면, 위 비동기적으로 로드 슬롯 요청에 설명된 대로 AsyncLoadDataRequest를 활성화해야 이 값을 조정할 수 있습니다. AsyncLoadSlotRequest가 비활성화되면 이러한 설정은 각각 30과 3의 고정된 레거시 값으로 되돌아갑니다.
configuration.properties 파일을 저장합니다.

프로세스 격리로 설정된 기본 시작 포트 재정의

이제 프로세스 격리가 활성화되면 직접 액세스 게이트웨이가 모든 격리된 커넥터 프로세스와의 프로세스 간 통신에 사용하는 기본 시작 포트(49152)를 재정의할 수 있습니다. 이는 기본 포트가 다른 프로세스에 의해 사용 중일 때 유용할 수 있습니다.

이 기능을 Qlik 지원에서 지시하는 경우에만 활성화해야 합니다.
직접 액세스 게이트웨이 1.7.8 이상이 필요합니다.
이 기능도 공개 API를 통해서 지원됩니다.

수행할 작업:

텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다.
# Connector Agent 섹션에서 다음 줄을 파일에 추가합니다.

DATA_PORT_RANGE_START=port-value

여기서 port-value은(는) 기본 시작 포트입니다.
configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

ODBC 데이터 소스에 연결할 때 발생하는 오류 메시지 세부 정보 증가

보안 문제로 인해 ODBC 드라이버에서 반환하는 기본 오류 메시지에는 최소한의 정보만 포함됩니다. 그러나 특정 시나리오에서는 특정 문제를 해결하기 위해 추가 정보가 필요할 수도 있습니다. 더 자세한 오류 메시지를 보려면 커넥터 대화 상자의 고급 섹션에 ShowErrorDetailMessage 속성을 추가하고 True로 설정합니다. 문제를 해결한 후 최적의 보안을 위해 해당 속성을 삭제하거나 False로 설정하는 것이 좋습니다.

메트릭 수집기

일반적인 고객 환경에서는 매일 수많은 데이터 다시 로드가 직접 액세스 게이트웨이를 통해 Qlik Cloud Analytics로 전달됩니다. 이러한 다시 로드로 인해 영향을 받는 리소스 소비와 사용률을 기록하고 모니터링하는 기능은 고객이 이에 따라 다시 로드를 계획하는 데 도움이 됩니다.

새 메트릭 수집기(직접 액세스 게이트웨이 컴퓨터에서 백그라운드로 실행됨)는 직접 액세스 게이트웨이, 커넥터 및 운영 체제의 리소스 활용에 대한 기본 로깅 및 모니터링을 제공합니다. 메트릭 수집기는 JSON 파일에서 로컬로 구성하거나 공개 API를 통해 구성할 수 있습니다.

메트릭 수집기 구성

직접 액세스 게이트웨이 컴퓨터에서 다음 파일을 열고 필요에 따라 구성합니다.

<설치 디렉터리>\ConnectorAgent\MetricsCollector\metricscollectorsettings.json

수집기 설정 구성(MetricsCollectorSettings)

Enabled: 메트릭 컬렉션을 활성화하려면 true(기본값)로 설정하고, 비활성화하려면 false로 설정합니다.
BaseScrapeIntervalSeconds: 커넥터 메트릭을 폴링하는 빈도(초)입니다. 각 커넥터마다 고유한 폴링 간격이 있습니다.
Port: API 또는 메트릭 커넥터(직접 액세스 게이트웨이를 통한 REST)에서 사용하는 포트입니다.
LocalDataRetentionDays: 지정된 값보다 오래된 데이터는 로컬 데이터베이스에서 삭제됩니다.
DataRetentionCheckIntervalMinutes: 보존 확인 빈도입니다.
LocalDatabaseFileLocation: 로컬 데이터베이스의 위치입니다. 이는 UNC 경로가 될 수도 있습니다. 기본 위치는 C:\ProgramData\Qlik\Gateway\tmp입니다.

커넥터 설정 구성(ConnectorConfigurations)

모든 직접 액세스 게이트웨이 커넥터의 경우 메트릭 폴링 간격(ScrapeIntervalSeconds)을 설정하고 메트릭 컬렉션을 활성화(true)하거나 비활성화(false)할 수 있습니다.

metricscollectorsettings.json 파일 예

{
  "MetricsCollectorSettings": {
    "Enabled": true,
    "BaseScrapeIntervalSeconds": 1,
    "Port": 5052,
    "LocalDataRetentionDays": 30,
    "DataRetentionCheckIntervalMinutes": 60,
    "LocalDatabaseFileLocation": ""
  },
  "ConnectorConfigurations": {
    "OdbcConnector": {
      "MetricsCollectionEnabled": true,
      "ScrapeIntervalSeconds": 30
    },
    "SystemMetrics": {
      "MetricsCollectionEnabled": true,
      "ScrapeIntervalSeconds": 30
    },
    "ConnectorAgent": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "RestConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapSqlConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapBwConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "SapPackageConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    },
    "FileConnector": {
      "MetricsCollectionEnabled": false,
      "ScrapeIntervalSeconds": 30
    }
  }
}

메트릭 로드

REST(직접 액세스 게이트웨이를 통해) 커넥터를 사용하여 직접 액세스 게이트웨이 컴퓨터에서 메트릭을 수집합니다.

수행할 작업:

REST(직접 액세스 게이트웨이를 통해) 연결 설정에서 localhost 연결 작업 허용을 활성화합니다.

자세한 내용은 REST 연결 만들기 (영어로만 제공)를 참조하십시오.
허용된 URL 목록에 http://localhost:5052/api/metrics를 추가합니다.

위의 REST 커넥터를 사용하여 직접 액세스 게이트웨이가 액세스할 수 있는 URL 제한을 참조하십시오.
직접 액세스 게이트웨이 서비스를 다시 시작합니다.
앱을 만들고 REST(직접 액세스 게이트웨이를 통해) 연결을 통해 http://localhost:5052/api/metrics에서 메트릭을 로드합니다.

지원되는 메트릭

시스템 메트릭:
- network_bytes_sent_total: 시스템이 시작된 이후 직접 액세스 게이트웨이를 통해 전송된 총 바이트 수
- network_bytes_received_total: 시스템이 시작된 이후 직접 액세스 게이트웨이을 통해 수신된 총 바이트 수
커넥터 메트릭:
- process_start_time_seconds: 프로세스가 시작된 이후 경과된 시간(초).
- process_cpu_seconds_total: CPU가 특정 상태에 있었던 누적 시간(초).
- process_virtual_memory_bytes: 프로세스에서 사용하는 가상 메모리의 현재 크기(바이트).
- process_working_set_bytes: 프로세스의 작업 집합의 현재 크기(바이트).
- process_private_memory_bytes: 프로세스에서 사용하는 비공개 메모리의 현재 크기(바이트).
- 프로세스_수_스레드: 프로세스에서 사용하는 스레드 수.

로그 파일 보기 및 다운로드

로그 파일은 직접 액세스 게이트웨이 작업에 대한 정보를 제공합니다. Qlik 지원에서 문제 해결을 위해 로그 파일 제공을 요청할 수 있습니다. 로그 뷰어에서 로그 파일을 보거나 다운로드할 수 있습니다. 정상적인 상황에서는 로그 파일을 검사할 이유가 없지만 반복적인 실패 또는 기타 문제가 발생하는 경우 로그 파일이 원인을 정확히 찾는 데 도움이 되는 경우가 많습니다.

로그를 보고 다운로드하려면 데이터를 소비할 수 있음 역할이 필요합니다.

로그 뷰어를 열려면:

관리 활동 센터에서 데이터 게이트웨이로 이동하여 직접 액세스 게이트웨이를 찾습니다.
행 끝에 있는 을 클릭하고 로그 보기를 선택합니다.

로그 뷰어 창이 열립니다.
왼쪽 위의 드롭다운 목록에서 Qlik 지원에서 보거나 다운로드하도록 요청한 로그 유형을 선택합니다.

다음 로그를 사용할 수 있습니다.
- 직접 액세스 게이트웨이 로그(DirectAccessAgent)
- DCaaS 로그(dcaas_logs)
- ODBC 기반 커넥터 로그(odbc-connector_logs)
- SAP BW 커넥터 로그(QvSAPBwConnector-<날짜 + 타임스탬프>)
- SAP SQL 커넥터 로그(QvSqlBwConnector-<날짜 + 타임스탬프>)
- 커넥터 에이전트 로그(connector-agent_logs_<날짜>)
- SAP ODP 및 SAP Report 커넥터 로그(QvSapConnectorPackage-<프로세스 ID>)
- REST 커넥터 로그(rest-connector_logs_<타임스탬프>)
- 파일 커넥터 로그(file-connector_logs_<타임스탬프>)
정보 메모직접 액세스 게이트웨이 1.7.1부터 커넥터 시작, 종료 및 다시 시작 이벤트가 직접 액세스 게이트웨이(DirectAccessAgent) 로그 파일에 기록됩니다. 이전 버전에서는 커넥터 에이전트 로그(connector-agent_logs_<날짜>) 로그 파일에 기록되었습니다.
옆에 있는 드롭다운 목록에서 보거나 다운로드하려는 로그를 선택합니다. 로그 파일은 최신(현재 활성 로그 파일)에서 가장 오래된 것으로 정렬됩니다. 로그 파일을 선택한 후 및 버튼을 사용하여 각각 로그 파일의 시작 또는 끝으로 이동할 수 있습니다.

팁 메모로그 파일 보기는 최신 메시지로 자동 업데이트되지 않습니다. 보기를 업데이트하려면 을 클릭하여 최신 메시지로 업데이트될 로그 파일의 끝으로 이동합니다.
로그 파일을 다운로드하려면 다운로드를 클릭합니다.

브라우저 설정에 따라 파일이 컴퓨터에 다운로드되거나 저장하라는 메시지가 표시됩니다.

직접 액세스 게이트웨이 컴퓨터의 직접 액세스 게이트웨이 로그 열기

관리 활동 센터에서 직접 액세스 게이트웨이(DirectAccessAgent) 로그를 다운로드할 수 있을 뿐만 아니라 직접 액세스 게이트웨이 컴퓨터에서 직접 열 수도 있습니다. 기본 설치에서 이러한 로그는 다음 위치에 있습니다.

C:\Program Files\Qlik\ConnectorAgent\data\logs

DirectAccessAgent 로깅 수준 변경

문제 해결을 위해 DirectAccessAgent 로그의 로깅 수준을 변경해야 할 수도 있습니다. DirectAccessAgent는 Qlik Cloud 서비스에 대한 연결을 담당합니다. DirectAccessAgent 로그의 로깅 세부 정보 수준을 보고 변경하려면 기본 설치의 경우 ConnectorAgent 하위 폴더(C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent )에서 다음 명령을 실행합니다.

현재 로깅 수준을 보려면 다음을 실행합니다.

connectoragent configuration getloggers
로깅 수준을 Trace로 설정하려면 다음을 실행합니다.

connectoragent configuration setloggers -l Root -v DEBUG
로깅 수준을 Verbose로 설정하려면 다음을 실행합니다.

connectoragent configuration setloggers -l Root –v DETAILED_DEBUG

추가 로깅 옵션에 대해서는 아래 Qlik Cloud에서 직접 액세스 게이트웨이 구성을 참조하십시오.

등록 키 업데이트

예상치 못하게 키가 손상되거나 권한이 없는 사용자가 데이터 게이트웨이 서버에 액세스한 것으로 의심되는 경우 등록 키를 변경해야 할 수 있습니다.

등록 키를 업데이트하려면:

직접 액세스 게이트웨이 서버에서 관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.
다음 명령을 실행합니다.
- 새 키 생성:
  
  connectoragent qcs generate_keys
- 키 표시:
  
  connectoragent qcs get_registration
  
  키가 표시됩니다.
위의 예와 같이 전체 키를 복사합니다.
관리 활동 센터에서 해당 행의 끝에 있는 버튼을 클릭하고 편집을 선택하여 데이터 게이트웨이 설정을 엽니다.
키 필드에 키를 붙여넣고(현재 키 교체) 설정을 저장합니다.
Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리에 설명된 대로 직접 액세스 게이트웨이 서버로 돌아가 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 알려 주십시오!

여기에 피드백을 남겨주십시오.