ドキュメントの検索
karat

+

K

APIリファレンス ↗

注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

コアコンセプト

Recipes アプリケーションは定常状態にあり、更新が停止されています。Foundry で条件を監視するために、他のアプリケーションや機能の検討をお勧めします。

  • オブジェクトモニタ: データの上にオブジェクトモニタを作成し、個々の検索やオブジェクトを追跡し、特定の条件が満たされた場合に通知や他のアクションをトリガーします。
  • Foundry Rules: データセット、オブジェクト、時系列に適用するロジックベースのルールを作成し、特定の条件が満たされたときにアラートをトリガーします。
  • 大規模な監視: チェックグループや監視ビューを使用して、データセット、エージェント、スケジュール、オブジェクト、リンクタイプを含む Foundry リソースのメトリック更新を表示します。
  • Workshop: アラート受信トレイやその他の通知ワークフローを構築し、特定の条件が満たされたときにトリガーされるアクションを設定します。

監視用ケースに適したワークフローの実装に関する質問があれば、Palantir サポートにお問い合わせください。

Recipes を使用する前に、Foundry でレシピの作成と使用を定義するコアコンセプト(有効期限、実行履歴、権限)について詳しく学ぶことをお勧めします。

有効期限

Recipes は継続的に動作するために計算リソースが必要です。使用されていないレシピがリソースを消費しないようにするため、レシピの有効期限を設定する必要があります。レシピが期限切れになると、削除されるわけではありません。期限切れのレシピは、監視対象の条件の追跡が停止するだけで、そのレシピの通知の受信者は通知されなくなります。レシピの有効期限が切れる前に、いくつかの間隔で著者に通知され、継続して実行させたい場合は、有効期限を延長することができます。そうしなかった場合やレシピが期限切れになった場合でも、レシピの再開と延長を選択することができます。

レシピの有効期限を変更するについて詳しく学ぶ。

実行履歴

スケジュールに基づいて、レシピは時間ベースのスケジュール(例えば、3 時間ごとや毎週月曜日の午前 9 時)またはイベントベースのスケジュール(データセットが更新されたときや新しいオブジェクトが検出されたとき)で実行されます。

レシピが実行されるたびに、実行履歴には以下の実行ステータスのいずれかが記録されます。

  • 例外付き成功: レシピは正常に実行され、リソースにアクセスできる受信者全員に通知しましたが、レシピをミュートしていない人もいます。このステータスは、一部の受信者がリソースにアクセスできず、通知を受け取れなかった場合に発生することがあります。レポートレシピの場合、例外付き成功は、一部の受信者に対してレポートのエクスポートが失敗し、代わりにリンクが送信された場合にも発生することがあります。レシピの権限とセキュリティについては、以下を参照してください。
  • 成功: レシピは正常に実行され、レシピをミュートしていないすべての人に通知されました。
  • スキップ: レシピは正常にトリガーされましたが、通知は送信されませんでした。これは、すべての受信者がレシピをミュートしているか、チェックしている条件が真でない場合に発生することがあります。
  • 失敗: レシピは正常に実行されず、実行中にエラーが発生しました。このエラーの詳細は、この実行のレシピ履歴を展開することで確認できます。

著者は、失敗と例外付き成功の通知を受け取ります。通知設定を構成するについて詳しく学ぶ。

プライバシー、権限、共有

レシピは、監視対象のリソースから権限を継承します。これは、リソースを表示できるユーザーはレシピを表示でき、リソースを所有するユーザーはレシピを編集できるなど、そのようなユーザーがレシピでできることを意味します。

レシピは、他のユーザーにメールでデータを送信することができますが、権限は、データにアクセスできるユーザーだけがそのデータをメールで受け取ることができるようにします。

権限の概要

定義

  • 著者/オーナー: レシピを作成したユーザー。
  • 受信者: レシピのメール/通知のトリガーを受け取るユーザー。
  • 監視対象のリソース: レシピが変更の対象として監視している実際のファイル(データセット、レポート、Quiver 解析など)。

以下の表は、ユーザーが Recipes で特定のアクションを実行するために必要な権限を示しています。

アクション 認可されたユーザー
レシピを表示する 著者または監視対象リソースに`Viewer`アクセス権があるユーザー
レシピを変更し、管理する 著者または監視対象リソースに`Owner`アクセス権があるユーザー
レシピからメール/通知を受け取る 監視対象リソースに`Viewer`アクセス権がある受信者 (1.)

受信者がレポートにアクセスできない場合でも、通知は受け取りますが、アクセスをリクエストするためのレポートへのリンクが表示されます。

ユーザーが、基本リソースにアクセスできない受信者をレシピに追加しようとする場合、受信者はレシピを表示できますが、リソースは表示できません。メール/通知は受信されますが、リンクされたリソースを開くことはできず、メール/通知には添付ファイルが含まれません。すべての受信者がメール/通知を受信できるようにするには、レシピのリソースに対して少なくとも Viewer アクセス権を持っていることを確認してください。