Sorun giderme Doğrudan Erişim ağ geçidi
Bu bölümde, Doğrudan Erişim ağ geçidi uygulamasında sorun gidermek için gerçekleştirebileceğiniz çeşitli eylemler açıklanır.
Günlük dosyalarının görüntülenmesi ve indirilmesi
Günlük dosyaları, Doğrudan Erişim ağ geçidi işlemleri hakkında bilgi sağlar. Qlik Destek, sorun giderme amacıyla sizden günlük dosyaları sağlamanızı isteyebilir. Günlük dosyalarını, Günlük görüntüleyicide görüntüleyebilir veya indirebilirsiniz. Normal koşullar altında, günlük dosyalarını incelemeye gerek yoktur ancak tekrarlayan hatalar veya başka sorunlar yaşıyorsanız günlük dosyaları genellikle sebebi belirlemenize yardımcı olur.
Günlük görüntüleyiciyi açmak için:
-
Yönetim etkinlik merkezinde, Veri ağ geçitleri'ne gidin ve size ait Doğrudan Erişim ağ geçidi öğesini bulun.
-
Satırın sonundaki
simgesine tıklayın ve Günlükleri görüntüle'yi seçin.
Günlük görüntüleyici penceresi açılır.
-
Sol üstte bulunan açılır listeden Qlik Desteğinin sizden görüntülemenizi veya indirmenizi istediği günlük türünü seçin.
Aşağıdaki günlükler kullanılabilir:
- Doğrudan Erişim ağ geçidi günlükleri (DirectAccessAgent)
- DCaaS günlükleri (dcaas_logs)
- ODBC tabanlı bağlayıcı günlükleri (odbc-connector_logs)
- SAP BW bağlayıcı günlükleri (QvSAPBwConnector-<date + timestamp>)
- SAP ODP bağlayıcı günlükleri (QvSapConnectorPackage-<process_id>)
- SAP SQL bağlayıcı günlükleri (QvSqlBwConnector-<date + timestamp>)
- Bağlayıcı aracı günlükleri (connector-agent_logs_<date>)
-
Bitişik açılır listeden görüntülemek veya indirmek istediğiniz günlüğü seçin. Günlük dosyaları, en yeniden (o anda etkin günlük dosyası) en eskiye doğru sıralanmıştır. Bir günlük dosyası seçtikten sonra günlük dosyasının başına veya sonuna atlamak için sırasıyla
ve
düğmelerini kullanabilirsiniz.
İpucu notuGünlük dosyasının görünümü, en son mesajları içerecek şekilde otomatik olarak güncellenmez. Görüntüyü güncellemek üzere günlük dosyasının sonuna atlamak içinöğesine tıkladığınızda en son mesajlarla güncellenecektir.
-
Günlük dosyasını indirmek için İndir'e tıklayın.
Dosya ya bilgisayarınıza indirilir ya da tarayıcı ayarlarınıza bağlı olarak dosyayı kaydetmeniz istenir.
Doğrudan Erişim ağ geçidi günlüklerini Doğrudan Erişim ağ geçidi makinesinde açma
Doğrudan Erişim ağ geçidi (DirectAccessAgent) günlüklerini Yönetim etkinlik merkezinden indirebilir ve aynı zamanda doğrudan Doğrudan Erişim ağ geçidi makinesinde açabilirsiniz. Varsayılan yükleme ile bu günlüklerin konumu şudur:
C:\Program Files\Qlik\ConnectorAgent\data\logs
Günlük düzeyini değiştirme
Doğrudan Erişim ağ geçidi günlüklerinin günlük tutma düzeyini aşağıda açıklandığı gibi değiştirebilirsiniz.
Bağlayıcı bileşenlerinin günlük tutma düzeyini değiştirme
Sorun giderme amacıyla, bağlayıcı bileşen günlüklerinin günlük tutma düzeyini değiştirmeniz gerekebilir.
Bunu yapmak için:
- C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Göster > Gizli öğeler seçeneğinin seçili olduğundan emin olun.
-
COMPONENT öğesinin aşağıdakilerden biri olabileceği <COMPONENT>_LOG_LEVEL özelliğini bulun:
- AGENT
- DCAAS
- ODBC
- SAPBW
- SAPSQL
- SAPPACKAGE
- FILE
- Aşağıdakilerden birine ayarlayın: ERROR, WARN, INFO veya DEBUG
-
configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
Bilgi notuDoğrudan Erişim ağ geçidi 1.7.1'den başlayarak, yalnızca AGENT bileşenini değiştirdiyseniz Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatmanız gerekmez.
DirectAccessAgent günlük düzeyini değiştirme
Sorun giderme amacıyla, DirectAccessAgent günlüklerinin günlük tutma düzeyini değiştirmeniz gerekebilir. DirectAccessAgent, Qlik Cloud hizmetlerine bağlantıdan sorumludur. DirectAccessAgent günlüklerinin günlük kaydetme ayrıntı düzeyini görüntülemek ve değiştirmek için ConnectorAgent alt klasöründen şu komutları çalıştırın (varsayılan bir yükleme ile C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent):
-
Geçerli günlük düzeyini görüntülemek için şunu çalıştırın:
connectoragent configuration getloggers -
Günlük düzeyini Trace olarak ayarlamak için şunu çalıştırın:
connectoragent configuration setloggers -l Root -v DEBUG -
Günlük düzeyini Verbose olarak ayarlamak için şunu çalıştırın:
connectoragent configuration setloggers -l Root –v DETAILED_DEBUG
Kayıt anahtarını güncelleme
Düşük bir olasılık olmakla birlikte kayıt anahtarının bozulması veya veri ağ geçidi sunucusuna yetkisiz bir kullanıcı tarafından erişildiğinden şüphelenmeniz halinde anahtarı değiştirmek gerekebilir.
Kayıt anahtarını güncellemek için:
- Doğrudan Erişim ağ geçidi sunucusunda yönetici olarak bir Komut İstemi açın ve çalışma dizinini ConnectorAgent alt klasörü olarak değiştirin (varsayılan yükleme ile C:\Program Files\Qlik\ConnectorAgent\ConnectorAgent).
-
Şu komutları çalıştırın:
-
Yeni anahtarı oluşturun:
connectoragent qcs generate_keys
-
Anahtarı gösterin:
connectoragent qcs get_registration
Anahtar gösterilir:
-
-
Anahtarın tamamını yukarıdaki örnekte gösterildiği gibi kopyalayın.
-
Yönetim etkinlik merkezinde, ilgili satırın sonundaki
düğmesine tıklayarak ve Düzenle'yi seçerek veri ağ geçidi ayarlarını açın.
-
Anahtarı Anahtar alanına yapıştırın (geçerli anahtarın yerine) ve ayarları kaydedin.
-
Doğrudan Erişim ağ geçidi sunucusuna geri dönün ve Qlik Data Gateway - Doğrudan Erişim hizmetini Qlik Data Gateway - Doğrudan Erişim hizmetini yönetme bölümünde anlatıldığı gibi yeniden başlatın.
Yeniden yükleme oturumu süresini uzatma
Doğrudan Erişim ağ geçidi ile Qlik Cloud arasındaki bağlantı 20 saniye veya daha uzun bir süredir boştaysa yeniden yükleme işlemi bazen aşağıdaki hatayı vererek başarısız olabilir:
Invalid object name '#<TempTableName>' (indicating that the Doğrudan Erişim ağ geçidi temp tables are unavailable).
Varsayılan oturum süresi 20 saniyedir, ancak bu hatayı sıklıkla alıyorsanız oturum süresini aşağıdaki gibi uzatabilirsiniz:
-
C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Gizli dosyaları, klasörleri ve sürücüleri göster seçeneğinin seçili olduğundan emin olun.
- ODBC_RELOAD_SESSION_LIFE parametresini bulun ve değerini gereken şekilde artırın.
- configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
Yükleme talepleri için zaman aşımını uzatma
Ağ kesintileri gerçekleştiğinde yeniden yüklemeler aşağıdaki hataları vererek başarısız olabilir:
Connector error: The session does not exist (DirectAccess-1509)
Connector error: The stream session expired for the load data request (DirectAccess-1012)
Yukarıdaki hatalarla sık sık karşılaşıyorsanız EXTEND_FIRST_REQUEST_TIMEOUT parametresini 5-10 dakika olarak ayarlamayı deneyin.
Bunu yapmak için:
-
C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Gizli dosyaları, klasörleri ve sürücüleri göster seçeneğinin seçili olduğundan emin olun.
- EXTEND_FIRST_REQUEST_TIMEOUT parametresini bulun ve değerini 5-10 dakikaya artırın. Varsayılan 0'dır.
- configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
Yeniden yükleme sırasında bağlayıcı çökmelerini ortadan kaldırma
İşlem izolasyonu, ağ geçidi sunucu işletim sistemine doğrudan erişimi olan yöneticilerin bağlayıcı türü başına yeniden yüklemeler için kaç işlemin bulunduğunu kontrol etmesine izin verir. Yeniden yüklemeleri birden fazla bağlayıcı işlemine dağıtmak, her bir bağlayıcı işleminde eş zamanlı olarak gerçekleşen yeniden yüklemelerin sayısını azaltarak izolasyon düzeyini artırır. Daha sonra bu, bağlayıcı çökmelerinin gerçekleştiği durumlarda genel Doğrudan Erişim ağ geçidi kararlılığı artırabilir.
Doğrudan Erişim ağ geçidi 1.6.1 veya daha yeni bir sürümü gerektirir.
İşlem izolasyonunu kapatma
Qlik Desteği, sorun giderme amacıyla işlem izolasyonunu kapatmanızı isteyebilir.
İşlem izolasyonunu kapatmak için:
- C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Gizli dosyaları, klasörleri ve sürücüleri göster seçeneğinin seçili olduğundan emin olun.
-
[ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE (Tüm satırları koşula göre renklendir) seçeneğini None (Belirtilen satırlar) olarak ayarlayın.
- configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
İşlem izolasyonunu açma veya eş zamanlı yeniden yükleme sayısını ya da eş zamanlı yeniden yüklemeleri değiştirme
İşlem izolasyonunu açmak veya eş zamanlı yeniden yükleme sayısını ya da eş zamanlı yeniden yüklemeleri değiştirmek için:
-
C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Gizli dosyaları, klasörleri ve sürücüleri göster seçeneğinin seçili olduğundan emin olun.
Dosya, farklı bağlayıcı türlerine karşılık gelen üç önek içerir: ODBC_<property-name>, SAPBW_<property-name>, SAPSQL_<property-name> ve SAPPACKAGE_<property-name>.
-
[ODBC|SAPBW|SAPSQL|SAPPACKAGE]_PROCESS_ISOLATION_MODE değerini Load olarak ve [ODBC|SAPBW|SAPSQL|SAPPACKAGE]_MAX_PROCESS_COUNT değerini N olarak ayarlayın.
Burada:
N = Bir komut işlemi + Atanacak eş zamanlı yeniden yükleme işlemlerinin sayısı. Yani örneğin 10 değeri, maksimum 9 eş zamanlı yeniden yüklemeyi ifade edecektir.
- configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
ODBC bağlayıcı işlem izolasyonu örnekleri
Aşağıdaki configuration.properties dosya alıntısı, en fazla 12 yeniden yükleme işlemi için ODBC bağlayıcı işlem izolasyonunun nasıl etkinleştirileceğini göstermektedir:
ODBC_PROCESS_ISOLATION_MODE=Load
ODBC_MAX_PROCESS_COUNT=13
Bir sorun olması durumunda yeniden yükleme için verileri önbelleğe alma
Her yeniden yükleme işlemi için Doğrudan Erişim ağ geçidi, veri yığınlarını bellekte önbelleğe alabilir ve diske boşaltabilir (önbelleğe alma için ayrılan boyut aşıldığında). Bu özellikle, otomatik kurtarmayı kullanmıyor ve 4025, 4020 ve 4021 hatalarıyla sık sık karşılaşıyorsanız faydalıdır. Veri yığınlarını diske yüklemek için (her yeniden yükleme için) önbellek boyut eşiğini ayarlayarak bu özelliği açın. Belirtilen eşiğe ulaşıldığında ağ geçidi, sonraki şifrelenmiş yığınları Doğrudan Erişim ağ geçidi makinesinin diskine yükleyecektir.
Önbellek boyutunu ayarlamak için:
-
C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Gizli dosyaları, klasörleri ve sürücüleri göster seçeneğinin seçili olduğundan emin olun.
-
RELOAD_CACHE_MEMORY_MB değerini N olarak ayarlayın (Varsayılan 0'dır ve bu, yeteneğin etkinleştirilmediği anlamına gelir).
Burada:
N = Veri yığınlarını önbelleğe almak için ayrılan bellek miktarı (her yeniden yükleme için)
Bilgi notuBu yeteneğin etkinleştirilmesi, Doğrudan Erişim ağ geçidi makinesindeki bellek kullanımını artırır, bu nedenle etkin olduğunda bellek üzerindeki etkiyi izlemenizi öneririz. RELOAD_CACHE_MEMORY_MB değerini 100 olarak ayarlamak çoğu durum için yeterli olacaktır. - configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
Varsayılan yığınlar önbellek dizinini geçersiz kılma
Her yeniden yükleme işlemi için Doğrudan Erişim ağ geçidi, veri yığınlarını bellekte önbelleğe alabilir ve diske boşaltabilir (önbelleğe alma için ayrılan boyut aşıldığında). Sistem sürücüsünde yeterli disk alanınız yoksa varsayılan yığın önbelleği dizinini (C:\ProgramData\Qlik\Gateway\tmp) geçersiz kılabilirsiniz.
Bunu yapmak için:
- Bir metin düzenleyicisi kullanarak C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Göster > Gizli öğeler seçeneğinin seçili olduğundan emin olun.
-
OVERRIDE_CHUNKS_CACHE_DIR özelliğini bulun ve seçtiğiniz dizine ayarlayın.
Örnek:
OVERRIDE_CHUNKS_CACHE_DIR=C:\tmp
Bilgi notuYolu tırnak işareti içine almayın. - configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
ODBC (Doğrudan Erişim ağ geçidi aracılığıyla) bağlayıcısıyla çalışırken varsayılan Qlik Cloud veri türünü geçersiz kılma
Bazen, satıcı ODBC sürücüsünün kaynak veri türlerini işlemesiyle ilgili bir sorun nedeniyle, yeniden yükleme sırasında bir hata meydana gelir veya Qlik Cloud hedefine yanlış veriler yüklenir. Bu gibi durumlarda, Qlik Cloud veri türünü veya teknik özelliğini (örneğin ölçek ya da hassasiyet) geçersiz kılabilirsiniz.
Bunu yapmak için:
- Bir metin düzenleyicisi kullanarak C:\ProgramData\Qlik\Gateway\custom_type_mapping.json dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Göster > Gizli öğeler seçeneğinin seçili olduğundan emin olun. Bu dosya Qlik Cloud veri türleri için örnek bir kaynak içerir.
-
Sorunlu veri türünü istenen Qlik Cloud veri türüyle eşleyen bir bölüm ekleyin.
Aşağıdaki örnekte (custom_type_mapping.json dosyasına dahil edilmiştir) müşterinin, Qlik Cloud DateTime veri türünün boyutunu 27 olarak değiştirmesi gerekmektedir.
{
"Identifier": "Amazon Athena ODBC (x64)",
"NativeDataType": "timestamp with time zone",
"QlikDataType": "DateTime",
"Size": 27,
"IsBit": false
}
- custom_type_mapping.json dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
- Verileri yeniden yükleyin.
Doğrudan Erişim ağ geçidi ile Qlik Cloud arasında yeniden bağlantı kurmayı zorlama
Varsayılan olarak, Doğrudan Erişim ağ geçidi ile Qlik Cloud arasındaki bağlantı kesilirse 45 saniye sonra yeniden bağlantı kurulması gerekir. Çok daha uzun sürdüğünü fark ederseniz ağ geçidini daha erken yeniden bağlanmaya zorlayabilirsiniz.
Bunu yapmak için:
- Bir metin düzenleyicisi kullanarak C:\ProgramData\Qlik\Gateway\configuration.properties dosyasını yönetici olarak açın. Bu işlemi Windows Explorer üzerinden yapıyorsanız Göster > Gizli öğeler seçeneğinin seçili olduğundan emin olun. Bu dosya Qlik Cloud veri türleri için örnek bir kaynak içerir.
-
Dosyanın başındaki # Connector Agent bölümüne AGENT_PONG_TIMEOUT_SECONDS=<time-in-seconds> ekleyin.
Örnek:
AGENT_PONG_TIMEOUT_SECONDS=30
Bilgi notuMinimum süre 30 saniyedir. - configuration.properties dosyasını kaydedin ve Qlik Data Gateway - Doğrudan Erişim hizmetini yeniden başlatın.
ODBC veri kaynaklarına bağlanırken hata mesajı ayrıntısını artırma
Güvenlik endişeleri nedeniyle, ODBC sürücüsü tarafından döndürülen varsayılan hata mesajı minimum bilgi içerir. Ancak bazı senaryolarda, belirli bir sorunu gidermek için daha fazla bilgiye ihtiyacınız olabilir. Daha ayrıntılı bir hata mesajı almak için bağlayıcı diyalog penceresinde Gelişmiş bölümüne ShowErrorDetailMessage özelliğini ekleyin ve True olarak ayarlayın. Sorununuzu çözdükten sonra, optimum güvenlik için özelliği silmeniz veya False olarak ayarlamanız kesinlikle tavsiye edilir.