문제 해결 직접 액세스 게이트웨이
이 섹션에서는 직접 액세스 게이트웨이 문제를 해결하기 위해 수행할 수 있는 다양한 작업에 대해 설명합니다.
로그 파일 보기 및 다운로드
로그 파일은 직접 액세스 게이트웨이 작업에 대한 정보를 제공합니다. Qlik 지원에서 문제 해결을 위해 로그 파일 제공을 요청할 수 있습니다. 로그 뷰어에서 로그 파일을 보거나 다운로드할 수 있습니다. 정상적인 상황에서는 로그 파일을 검사할 이유가 없지만 반복적인 실패 또는 기타 문제가 발생하는 경우 로그 파일이 원인을 정확히 찾는 데 도움이 되는 경우가 많습니다.
로그 뷰어를 열려면:
-
관리 활동 센터에서 데이터 게이트웨이로 이동하여 직접 액세스 게이트웨이를 찾습니다.
-
행 끝에 있는
을 클릭하고 로그 보기를 선택합니다.
로그 뷰어 창이 열립니다.
-
왼쪽 위의 드롭다운 목록에서 Qlik 지원에서 보거나 다운로드하도록 요청한 로그 유형을 선택합니다.
다음 로그를 사용할 수 있습니다.
- 직접 액세스 게이트웨이 로그(DirectAccessAgent)
- DCaaS 로그(dcaas_logs)
- ODBC 기반 커넥터 로그(odbc-connector_logs)
- SAP BW 커넥터 로그(QvSAPBwConnector-<날짜 + 타임스탬프>)
- SAP ODP 커넥터 로그(QvSapConnectorPackage-<프로세스 ID>)
- SAP SQL 커넥터 로그(QvSqlBwConnector-<날짜 + 타임스탬프>)
- 커넥터 에이전트 로그(connector-agent_logs_<날짜>)
-
옆에 있는 드롭다운 목록에서 보거나 다운로드하려는 로그를 선택합니다. 로그 파일은 최신(현재 활성 로그 파일)에서 가장 오래된 것으로 정렬됩니다. 로그 파일을 선택한 후
및
버튼을 사용하여 각각 로그 파일의 시작 또는 끝으로 이동할 수 있습니다.
팁 메모로그 파일 보기는 최신 메시지로 자동 업데이트되지 않습니다. 보기를 업데이트하려면을 클릭하여 최신 메시지로 업데이트될 로그 파일의 끝으로 이동합니다.
-
로그 파일을 다운로드하려면 다운로드를 클릭합니다.
브라우저 설정에 따라 파일이 컴퓨터에 다운로드되거나 저장하라는 메시지가 표시됩니다.
직접 액세스 게이트웨이 컴퓨터의 직접 액세스 게이트웨이 로그 열기
관리 활동 센터에서 직접 액세스 게이트웨이(DirectAccessAgent) 로그를 다운로드할 수 있을 뿐만 아니라 직접 액세스 게이트웨이 컴퓨터에서 직접 열 수도 있습니다. 기본 설치에서 이러한 로그는 다음 위치에 있습니다.
C:\Program Files\Qlik\ConnectorAgent\data\logs
로깅 수준 변경
아래 설명된 대로 직접 액세스 게이트웨이 로그의 로깅 수준을 변경할 수 있습니다.
커넥터 구성 요소의 로깅 수준 변경
문제 해결을 위해 커넥터 구성 요소 로그의 로깅 수준을 변경해야 할 수도 있습니다.
그렇게 하려면:
- C:\ProgramData\Qlik\Gateway\configuration.properties 를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다.
-
<COMPONENT>_LOG_LEVEL 속성을 찾습니다. 여기서 COMPONENT는 다음 중 하나일 수 있습니다.
- AGENT
- DCAAS
- ODBC
- SAPBW
- SAPSQL
- SAPPACKAGE
- FILE
- 다음 중 하나로 설정합니다. ERROR, WARN, INFO, DEBUG
-
configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
정보 메모직접 액세스 게이트웨이 1.7.1부터 AGENT 구성 요소만 변경한 경우 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작할 필요가 없습니다.
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
등록 키 업데이트
예상치 못하게 키가 손상되거나 권한이 없는 사용자가 데이터 게이트웨이 서버에 액세스한 것으로 의심되는 경우 등록 키를 변경해야 할 수 있습니다.
등록 키를 업데이트하려면:
- 직접 액세스 게이트웨이 서버에서 관리자로 명령 프롬프트를 열고 작업 디렉터리를 ConnectorAgent 하위 폴더(기본 설치의 경우 C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent)로 변경합니다.
-
다음 명령을 실행합니다.
-
새 키 생성:
connectoragent qcs generate_keys
-
키 표시:
connectoragent qcs get_registration
키가 표시됩니다.
-
-
위의 예와 같이 전체 키를 복사합니다.
-
관리 활동 센터에서 해당 행의 끝에 있는
버튼을 클릭하고 편집을 선택하여 데이터 게이트웨이 설정을 엽니다.
-
키 필드에 키를 붙여넣고(현재 키 교체) 설정을 저장합니다.
-
Qlik 데이터 게이트웨이 - 직접 액세스 서비스 관리에 설명된 대로 직접 액세스 게이트웨이 서버로 돌아가 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
다시 로드 세션 수명 연장
직접 액세스 게이트웨이 및 Qlik Cloud 간의 연결이 20초 이상 유휴 상태인 경우 다음 오류와 함께 다시 로드 작업이 실패할 수 있습니다.
Invalid object name '#<TempTableName>' (indicating that the 직접 액세스 게이트웨이 temp tables are unavailable).
기본 세션 수명은 20초이지만, 이 오류가 자주 발생하는 경우 다음과 같이 세션 수명을 연장할 수 있습니다.
-
C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.
- ODBC_RELOAD_SESSION_LIFE 매개 변수를 찾아 필요에 따라 값을 늘립니다.
- configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
로드 요청에 대한 제한 시간 연장
네트워크 중단이 발생하면 다음 오류와 함께 다시 로드가 실패할 수 있습니다.
Connector error: The session does not exist (DirectAccess-1509)
Connector error: The stream session expired for the load data request (DirectAccess-1012)
위의 오류가 자주 발생하는 경우 EXTEND_FIRST_REQUEST_TIMEOUT 매개 변수를 5~10분으로 설정해 보십시오.
수행할 작업:
-
C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.
- EXTEND_FIRST_REQUEST_TIMEOUT 매개 변수를 찾아 값을 5~10분으로 늘립니다. 기본값은 "0"입니다.
- configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
다시 로드 중 커넥터 충돌 완화
프로세스 격리를 통해 관리자는 게이트웨이 서버 운영 체제에 직접 액세스하여 커넥터 유형별로 다시 로드할 수 있는 프로세스 수를 제어할 수 있습니다. 여러 커넥터 프로세스에 다시 로드를 분산시키면 각 커넥터 프로세스에서 동시에 실행되는 다시 로드 수가 줄어들어 격리 수준이 높아집니다. 결과적으로 커넥터 충돌이 발생한 경우 전반적인 직접 액세스 게이트웨이 안정성이 향상될 수 있습니다.
직접 액세스 게이트웨이 1.6.1 이상이 필요합니다.
프로세스 격리 해제
Qlik 지원 센터에서는 문제 해결을 위해 프로세스 격리 해제를 요청할 수 있습니다.
프로세스 격리를 끄려면 다음을 수행합니다.
- C:\ProgramData\Qlik\Gateway\configuration.properties 파일을 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.
-
[ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE(조건부 모든 행 색 지정)을 None(지정된 행)으로 설정합니다.
- configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
프로세스 격리 켜거나 동시 다시 로드 수 변경
프로세스 격리를 켜거나 동시 다시 로드 수를 변경하려면:
-
C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.
파일에는 다양한 커넥터 유형에 해당하는 세 가지 접두사가 포함되어 있습니다. ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> 및 SAPPACKAGE_<property-name>.
-
[ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE를 Load 로 설정하고 [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT를 N으로 설정합니다.
여기서:
N = 명령 프로세스 1개 + 할당할 동시 다시 로드 프로세스 수입니다. 예를 들어, 값 10은 최대 9개의 동시 다시 로드를 의미합니다.
- configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
ODBC 커넥터 프로세스 격리 예
configuration.properties 파일 중 다음 부분은 최대 12번의 다시 로드에 대해 ODBC 커넥터 프로세스 격리를 활성화하는 방법을 보여 줍니다.
ODBC_PROCESS_ISOLATION_MODE=Load
ODBC_MAX_PROCESS_COUNT=13
문제 발생 시 다시 로드하기 위한 데이터 캐싱
각각의 다시 로드 작업에 대해 직접 액세스 게이트웨이는 메모리에 데이터 청크를 캐시하고 이를 디스크로 오프로드할 수 있습니다(캐싱에 할당된 크기를 초과하는 경우). 이는 자동 복구를 사용하지 않고 4025, 4020 및 4021 오류가 자주 발생하는 경우 특히 유용합니다. 데이터 청크를 디스크로 오프로드하기 위한 캐시 크기 threshold를 설정하여 이 기능을 켭니다(다시 로드할 때마다). 지정된 threshold에 도달하면 게이트웨이는 다음 암호화된 청크를 직접 액세스 게이트웨이 컴퓨터의 디스크로 오프로드합니다.
캐시 크기를 설정하려면:
-
C:\ProgramData\Qlik\Gateway\configuration.properties를 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 숨김 파일, 폴더 및 드라이브 표시가 선택되어 있는지 확인합니다.
-
RELOAD_CACHE_MEMORY_MB를 N으로 설정합니다. 기본값은 0이며 기능이 활성화되지 않음을 의미합니다.
여기서:
N = 데이터 청크 캐싱에 할당된 메모리 양(다시 로드할 때마다)
정보 메모이 기능을 활성화하면 직접 액세스 게이트웨이 컴퓨터의 메모리 소비가 증가하므로 활성화된 동안 메모리에 미치는 영향을 모니터링하는 것이 좋습니다. 대부분의 상황에서는 RELOAD_CACHE_MEMORY_MB 값을 100으로 설정하면 충분합니다. - configuration.properties 파일을 저장하고 Qlik 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
기본 청크 캐시 디렉터리 재정의
각각의 다시 로드 작업에 대해 직접 액세스 게이트웨이는 메모리에 데이터 청크를 캐시하고 이를 디스크로 오프로드할 수 있습니다(캐싱에 할당된 크기를 초과하는 경우). 시스템 드라이브에 충분한 디스크 공간이 없으면 기본 청크 캐시 디렉터리(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 데이터 유형 재정의
공급업체 ODBC 드라이버가 소스 데이터 유형을 처리하는 데 문제가 있어 다시 로드하는 동안 오류가 발생하거나 잘못된 데이터가 Qlik Cloud에 로드되는 경우가 있습니다. 이러한 경우 Qlik Cloud 데이터 유형 또는 해당 사양(예: 배율 또는 정밀도)을 재정의할 수 있습니다.
수행할 작업:
- 텍스트 편집기를 사용하여 C:\ProgramData\Qlik\Gateway\custom_type_mapping.json을 관리자 권한으로 엽니다. Windows 탐색기를 통해 이 작업을 수행하는 경우 표시 > 숨겨진 항목이 선택되어 있는지 확인합니다. 이 파일에는 Qlik Cloud 데이터 유형에 대한 예 소스가 포함되어 있습니다.
-
문제가 있는 데이터 유형을 원하는 Qlik Cloud 데이터 유형에 매핑하는 섹션을 추가합니다.
다음 예(custom_type_mapping.json 파일에 포함됨)에서 고객은 Qlik Cloud DateTime 데이터 유형의 크기를 27로 변경해야 합니다.
{
"Identifier": "Amazon Athena ODBC (x64)",
"NativeDataType": "timestamp with time zone",
"QlikDataType": "DateTime",
"Size": 27,
"IsBit": false
}
- custom_type_mapping.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 데이터 게이트웨이 - 직접 액세스 서비스를 다시 시작합니다.
ODBC 데이터 소스에 연결할 때 발생하는 오류 메시지 세부 정보 증가
보안 문제로 인해 ODBC 드라이버에서 반환하는 기본 오류 메시지에는 최소한의 정보만 포함됩니다. 그러나 특정 시나리오에서는 특정 문제를 해결하기 위해 추가 정보가 필요할 수도 있습니다. 더 자세한 오류 메시지를 보려면 커넥터 대화 상자의 고급 섹션에 ShowErrorDetailMessage 속성을 추가하고 True로 설정합니다. 문제를 해결한 후 최적의 보안을 위해 해당 속성을 삭제하거나 False로 설정하는 것이 좋습니다.