Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mengatasi masalah sumber data
Bagian ini dapat membantu Anda memecahkan masalah umum saat mengonfigurasi dan menggunakan Amazon Kendra konektor sumber data.
Dokumen saya tidak diindeks
Saat Anda menyinkronkan Amazon Kendra indeks dengan sumber data, Anda mungkin mengalami masalah yang mencegah dokumen diindeks. Pengindeksan adalah proses dua langkah. Pertama, sumber data diperiksa untuk dokumen baru dan diperbarui untuk diindeks, dan untuk menemukan dokumen untuk dihapus dari indeks. Kedua, pada tingkat dokumen, setiap dokumen diakses dan diindeks.
Kesalahan dapat terjadi di salah satu langkah berikut. Kesalahan tingkat sumber data dilaporkan di konsol dalam bagian riwayat jalan sinkronisasi dari halaman detail sumber data. Status tugas sinkronisasi dapat Berhasil, Tidak lengkap, atau Gagal. Anda juga dapat melihat jumlah dokumen yang diindeks dan dihapus selama tugas berlangsung. Jika statusnya adalah Gagal, pesan akan ditampilkan dalam kolom Detail.
Kesalahan tingkat dokumen dilaporkan di Amazon CloudWatch Logs. Anda dapat melihat kesalahan menggunakan CloudWatch konsol.
Untuk membuat laporan status sinkronisasi dokumen, lihat Saya ingin membuat laporan status sinkronisasi untuk dokumen saya.
Tugas sinkronisasi saya gagal
Tugas sinkronisasi biasanya gagal ketika ada kesalahan konfigurasi dalam indeks atau sumber data. Di konsol, Anda dapat menemukan pesan kesalahan di bagian Sync run history pada halaman detail sumber data, di bawah kolom Detail. Kesalahan tingkat dokumen dilaporkan di Amazon CloudWatch Logs. Pesan kesalahan memberikan informasi tentang apa yang salah. Masalahnya biasanya indeks atau sumber data tidak memiliki yang tepat IAM izin. Pesan kesalahan menjelaskan izin yang hilang. Berikut beberapa pesan kesalahan yang dapat Anda terima:
Failed to create log group for job. Please make sure that the IAM role provided has sufficient permissions.
Jika peran indeks Anda tidak memiliki izin untuk digunakan CloudWatch, sumber data tidak akan dapat membuat CloudWatch log. Jika Anda mendapatkan kesalahan ini, Anda harus menambahkan CloudWatch izin untuk peran indeks.
Failed to access Amazon S3 file prefix (
bucket
name
) while trying to crawl your metadata files. Please make
sure the IAM role (ARN
) provided has
sufficient permissions.
Ketika Anda menggunakan sebuah Amazon S3 sumber data, Amazon Kendra harus memiliki izin untuk mengakses bucket yang berisi dokumen. Anda perlu menambahkan izin untuk Amazon Kendra untuk membaca bucket ke sumber data IAM peran.
The provided IAM role (
ARN
) could
not be assumed. Please make sure Amazon Kendra is a trusted entity that is
allowed to assume the role.
Amazon Kendra membutuhkan izin untuk mengasumsikan indeks dan sumber data IAM peran. Anda perlu menambahkan kebijakan kepercayaan ke peran dengan izin untuk tindakan sts:AssumeRole
.
Untuk IAM kebijakan yang Amazon Kendra perlu mengindeks sumber data, lihat IAM peran.
Untuk membuat laporan status sinkronisasi dokumen, lihat Saya ingin membuat laporan status sinkronisasi untuk dokumen saya.
Tugas sinkronisasi saya tidak lengkap
Pekerjaan umumnya tidak lengkap ketika mereka telah menyelesaikan proses tingkat sumber data tetapi memiliki beberapa kesalahan selama proses tingkat dokumen. Ketika pekerjaan tidak lengkap, beberapa dokumen mungkin tidak berhasil diindeks. Untuk Amazon S3 Sumber data, pekerjaan yang tidak lengkap biasanya disebabkan oleh:
-
Metadata yang tidak valid untuk satu atau lebih dokumen.
-
Ketika dokumen diserahkan untuk pengindeksan tetapi setidaknya satu dokumen tidak diserahkan.
-
Ketika dokumen diserahkan untuk dihapus dari indeks tetapi setidaknya satu dokumen tidak diserahkan.
Untuk memecahkan masalah pekerjaan sinkronisasi yang tidak lengkap, lihat dulu CloudWatch log.
-
Dari kolom detail, pilih Lihat detail di CloudWatch.
-
Meninjau pesan kesalahan untuk melihat apa yang menyebabkan dokumen gagal.
Untuk membuat laporan status sinkronisasi dokumen, lihat Saya ingin membuat laporan status sinkronisasi untuk dokumen saya.
Tugas sinkronisasi saya berhasil tetapi tidak ada dokumen yang diindeks
Kadang-kadang, pekerjaan sinkronisasi indeks akan ditandai sebagai Berhasil tetapi tidak ada dokumen baru atau diperbarui yang diindeks saat Anda mengharapkannya. Alasan yang mungkin termasuk:
-
Periksa CloudWatch
DocumentsSubmittedForIndexingFailed
metrik untuk melihat apakah ada dokumen yang gagal disinkronkan. Periksa Anda CloudWatch log untuk detailnya. -
Untuk Amazon S3 sumber data, Anda mungkin telah memberikan Amazon Kendra nama bucket atau awalan yang salah. Pastikan ember itu Amazon Kendra yang menggunakan adalah salah satu yang berisi dokumen untuk diindeks.
-
Saat mengindeks ulang dokumen yang gagal diindeks di pekerjaan sebelumnya, Amazon Kendra tidak akan mengindeksnya kecuali Anda telah mengubah dokumen atau file metadata terkait.
Untuk membuat laporan status sinkronisasi dokumen, lihat Saya ingin membuat laporan status sinkronisasi untuk dokumen saya.
Saya mengalami masalah format file saat menyinkronkan sumber data saya
Jika Anda mengalami masalah format file saat menambahkan file ke sumber data Anda atau menyinkronkan sumber data Anda, pastikan bahwa jenis dokumen Anda Amazon Kendra didukung. Untuk daftar jenis dokumen yang didukung oleh Amazon Kendra lihat Jenis atau format dokumen.
Jika Anda menggunakan BatchPutDocument
API dengan file teks biasa, tentukan PLAIN_TEXT
sebagai jenis konten.
Saya ingin membuat laporan riwayat sinkronisasi untuk dokumen saya
Anda dapat melihat laporan riwayat proses sinkronisasi tingkat dokumen CloudWatch untuk pekerjaan sinkronisasi sumber data Anda dengan memilih Lihat Laporan. Laporan riwayat proses sinkronisasi akan memiliki detail tentang kemajuan dan status setiap dokumen dalam pekerjaan sinkronisasi. Ini menunjukkan apakah dokumen berhasil, gagal, atau dilewati selama tahap crawl, sinkronisasi, dan indeks. Anda juga akan menemukan pesan kesalahan yang terkait dengan dokumen yang gagal atau dilewati. Jika laporan tidak menampilkan hasil untuk pekerjaan sinkronisasi yang sedang berlangsung, log mungkin belum tersedia. Periksa kembali nanti karena data dipancarkan ke laporan saat peristiwa terjadi selama proses sinkronisasi.
Untuk mengakses laporan riwayat proses sinkronisasi, lakukan langkah-langkah berikut:
-
Buka konsol Amazon Kendra di. https://console.aws.amazon.com/kendra/
-
Dari menu navigasi kiri, di bawah Manajemen data, pilih Sumber data, lalu pilih sumber data Anda.
-
Dari halaman ringkasan sumber data Anda, gulir ke bawah dan pilih tab Sync history.
-
Dari Sync run history, pilih Actions.
-
Dari Tindakan, pilih Lihat laporan. Anda akan diarahkan ke CloudWatch konsol tempat Anda dapat mengakses laporan Anda.
catatan
Riwayat proses sinkronisasi mencatat jika dokumen berhasil diindeks selama konsumsi, termasuk terlampir ACLs dan metadata, untuk semua konektor yang didukung Amazon Kendra.
Jika Anda menggunakan konektor Amazon S3:
Selain melihat laporan riwayat proses sinkronisasi tingkat dokumen CloudWatch, Anda dapat membuat laporan riwayat sinkronisasi untuk setiap dokumen di sumber data Amazon S3 Anda dan menyalinnya ke Amazon S3 bucket. Selama proses ini, data Anda dienkripsi menggunakan AWS KMS kunci dan hanya dapat dilihat oleh Anda. Status dokumen yang dilaporkan dapat berupa salah satu dari berikut: Gagal, Selesai, atau Berhasil dengan kesalahan. Sebelum Anda dapat membuat laporan status sinkronisasi untuk Amazon S3, Anda harus melakukan hal berikut:
-
Tambahkan berikut ini Amazon Kendra kepala layanan untuk Anda Amazon S3 kebijakan akses
{ “Version”: “2012-10-17", “Statement”: [ { “Sid”: “KendraS3Access”, “Effect”: “Allow”, “Principal”: { “Service”: “kendra.amazonaws.com” }, “Action”: “s3:PutObject”, “Resource”: “arn:aws:s3:::your-manifest-bucket-name/*” } ] }
-
Buat sebuah Amazon S3 bucket dengan izin akses ke Amazon Kendra
Jika Anda menggunakan konsol, untuk membuat laporan riwayat sinkronisasi untuk Amazon S3, pilih untuk mengaktifkan opsi Hasilkan laporan dari Sinkronkan laporan riwayat — bagian opsional di halaman Detail sumber data. Kemudian, masukkan Amazon S3 lokasi bucket dan pilih dari opsi konfigurasi yang tersedia. Laporan akan dihasilkan dari sinkronisasi berikutnya setelah Anda mengaktifkan laporan generate.
Jika Anda menghapus Amazon S3 bucket, Anda akan kehilangan data log Anda dan harus menyiapkan bucket baru untuk menyimpan laporan sinkronisasi baru.
catatan
Laporan riwayat sinkronisasi hanya menyediakan informasi tentang apakah konektor Amazon S3 berhasil merayapi dan mencerna data.
Berapa lama waktu yang dibutuhkan untuk menyinkronkan sumber data?
Jika tidak ada pembaruan pada dokumen, sinkronkan waktu untuk Amazon Kendra indeks meningkat dalam proporsi linier dengan jumlah dokumen. Misalnya, 1.000 dokumen tanpa pembaruan akan memakan waktu sekitar lima menit untuk disinkronkan dan 2.000 dokumen tanpa pembaruan akan memakan waktu sekitar 10 menit. Jika ada pembaruan pada dokumen, maka waktu sinkronisasi akan meningkat berdasarkan jumlah dokumen yang diperbarui.
Berapa biaya untuk menyinkronkan sumber data?
Saat Anda menyinkronkan indeks Anda, dibutuhkan dua menit untuk melakukan pemanasan dan mengaktifkan Amazon EC2 untuk membangun koneksi yang diperlukan. Anda tidak dikenakan biaya selama proses ini. Pengukur penggunaan Anda dimulai hanya setelah pekerjaan sinkronisasi dimulai. Untuk informasi lebih lanjut tentang Amazon Kendra harga, lihat Amazon Kendra
harga
Saya mendapatkan sebuah Amazon EC2 kesalahan otorisasi
Jika sebuah Amazon EC2 kesalahan operasi yang tidak sah terjadi selama sinkronisasi untuk sumber data cloud pribadi virtual (VPC), kemungkinan Anda VPC IAM peran tidak memiliki izin yang diperlukan. Silakan periksa bahwa IAM peran yang Anda gunakan untuk sumber data Anda memiliki izin terlampir. Untuk informasi selengkapnya, lihat Virtual private cloud IAM peran.
Saya tidak dapat menggunakan tautan indeks pencarian untuk membuka Amazon S3 objek
Klaster Amazon Kendra index hanya dapat mengakses file yang Amazon S3 sumber data memberinya izin untuk mengakses. Misalnya, Amazon Kendra tidak dapat memodifikasi Amazon S3 izin yang menentukan apakah suatu objek dimaksudkan untuk menjadi publik atau dienkripsi. Amazon Kendra juga tidak memiliki izin default untuk membuat atau mengembalikan tautan yang ditandatangani Amazon S3 benda. Jika Anda ingin mengaktifkan penautan yang ditandatangani untuk Amazon S3 objek dalam a Amazon Kendra indeks, Anda memiliki dua opsi:
-
Anda dapat menggunakan tanda tangani hasil kueri indeks Anda dengan objek uri sumber sebelum mengembalikan hasilnya ke halaman pencarian. Untuk step-by-step panduan proses ini, lihat Berbagi objek menggunakan presigned. URLs
-
Anda dapat mengganti Amazon S3 objek metadata sumber uri dan membuat layanan Anda tersedia melalui CloudFront jaringan pengiriman konten (CDN) terhubung ke Amazon S3 bucket. Atau, Anda dapat menggunakan API Gateway titik akhir proxy yang mengembalikan presigned URL dan mengarahkan ulang ke sana.
Saya mendapatkan pesan kesalahan AccessDenied Saat Menggunakan File SSL Sertifikat
Jika Anda mendapatkan kesalahan akses ditolak saat menggunakan SSL sertifikat dengan sumber data Anda, pastikan IAM peran memiliki izin untuk mengakses file SSL sertifikat di lokasi yang ditentukan. Jika sertifikat dienkripsi dengan AWS KMS kunci, Anda IAM peran juga harus memiliki izin untuk mendekripsi menggunakan AWS KMS kunci. Untuk informasi selengkapnya, lihat Otentikasi dan kontrol akses AWS KMS.
Saya mendapatkan kesalahan otorisasi saat menggunakan sumber SharePoint data
Jika Anda mendapatkan kesalahan otorisasi saat menyinkronkan indeks Anda dengan sumber SharePoint data, konfirmasikan bahwa Anda memiliki peran Admin Situs yang ditetapkan untuk Anda. SharePoint
Indeks saya tidak merayapi dokumen dari sumber data Confluence saya
Jika Amazon Kendra index tidak merayapi dokumen dari sumber data Confluence Anda selama proses sinkronisasi, mengonfirmasi bahwa Anda adalah bagian dari Grup Administrator di Confluence.