カスタマイズと権限

同時接続によるリクエストの最適化

Things Cloud プラットフォームへのリクエストのパフォーマンスを向上させるために、ストリーミング分析では複数のクライアント接続を使用してリクエストを同時に実行します。これによりパフォーマンスが向上しますが、リクエストが実行されてレスポンスが返される順序も変更される可能性があります。デフォルトでは、Things Cloud トランスポートは複数の接続の使用を試み、EPL アプリケーションに影響を与える可能性のある競合を避けるために順序を制限します。

必要に応じて、順序が維持されるように努めます。たとえば、単一のマネージドオブジェクトに対するすべての更新は、トランスポートに送信された順序でシリアルに実行されます。詳細については、Apamaドキュメントの同時接続によるリクエストの最適化をご覧ください。

デフォルトのクライアント接続数は、「streaminganalytics」カテゴリの「client.numClients」テナントオプションで調整できます。例えば：

{
   "category": "streaminganalytics",
   "key": "client.numClients",
   "value": "5"
}

完全なシリアル転送が必要な場合は、client.numClients の値を 1 に設定します。

備考

これは、Apama-ctrl-smartrules マイクロサービスには適用されません。このオプションには固定値 1 (つまり、完全なシリアル) があり、これは構成できません。

ストリーミング分析アプリケーションのアクセス制御

デフォルトでは、ストリーミング分析アプリケーションを使用すると、Analytics Builder ページと EPLアプリ ページにアクセスできます。管理者は、テナントやユーザーごとに表示するカードを制御したり、ホーム画面のカードの文言を変更したりすることができます (ストリーミング分析アプリケーションのホーム画面のカスタマイズもご覧ください)。

どのページが利用可能かは、実行されている Apama-ctrl マイクロサービスの種類によっても異なります。

マイクロサービスが実行されていない場合は、マイクロサービスにアクセスできないことを示すエラーメッセージが表示されます。ホーム画面にはスマートルールに関する情報が記載されたカードのみが表示されます。

Apama-ctrl-smartrules マイクロサービスが実行されている場合、Analytics Builder ページも EPLアプリ ページも表示されません (また、有効にすることもできません)。この場合、スマートルールに関する情報が記載されたカードのみがホーム画面に表示されます。
Apama-ctrl マイクロサービスの他の種類では、Analytics Builder ページと EPLアプリ ページの両方がデフォルトで表示されます。

テナント全体の場合、「feature-disable-analyticsbuilder」および/または「feature-disable-eplapps」という名前の「機能アプリケーション」がテナント内で利用可能な場合、関連する部分は無効になります。これは、テナント内で行うことも、親テナントまたはマネジメントテナントによって行うこともできます。その後、サブテナントをサブスクライブします (親テナントが希望した場合、サブテナント管理者はこのアプリケーションのサブスクライブを解除できなくなります) 機能へのアクセスを制限します)。このような「機能アプリケーション」をテナント内に作成するには、POST リクエストを /application/applications に送信します。 (アプリケーションを作成する権限を持つ管理者として)。たとえば、Analytics Builder を無効にするには:

{
   "name":"feature-disable-analyticsbuilder",
   "contextPath": "feature-disable-analyticsbuilder",
   "type":"HOSTED",
   "resourcesUrl":"/",
   "manifest": {
       "noAppSwitcher": true
   },
   "key":"feature-disable-analyticsbuilder-key"
}

または、EPLアプリを無効にするには:

{
   "name":"feature-disable-eplapps",
   "contextPath": "feature-disable-eplapps",
   "type":"HOSTED",
   "resourcesUrl":"/",
   "manifest": {
       "noAppSwitcher": true
   },
   "key":"feature-disable-eplapps-key"
}

たとえば、Analytics Builder を無効にするために、curl コマンドを使用して POST リクエストを送信することもできます。

curl --user username -X POST -H 'Content-Type: application/json' -d '{"name":"feature-disable-analyticsbuilder", "contextPath": "feature-disable-analyticsbuilder", "type":"HOSTED", "resourcesUrl":"/","manifest": {"noAppSwitcher": true},"key":"feature-disable-analyticsbuilder-key"}' -k https://{{hostname}}/application/applications/

または、EPLアプリを無効にするには:

curl --user username -X POST -H 'Content-Type: application/json' -d '{"name":"feature-disable-eplapps", "contextPath": "feature-disable-eplapps", "type":"HOSTED", "resourcesUrl":"/", "manifest": {"noAppSwitcher": true},"key":"feature-disable-eplapps-key"}' -k https://{{hostname}}/application/applications/

デフォルトでは、すべてのユーザーが同じページのセットを表示できます (上記の制限に従って)。ページの表示を、ROLE_ANALYTICSBUILDER_READ または ROLE_EPLAPPS_READ 権限を持つユーザーのみに制限することもできます。これは、ユーザーに直接割り当てることも、グループ経由で割り当てることもできます (ユーザーガイド の管理 > 権限の管理もご覧ください)。これを有効にするには、テナントオプションのカテゴリを「streaminganalytics」に設定し、「applicationAccess」キーを値「role」に設定します。 (Things Cloud OpenAPI仕様の Tenant API もご覧ください) または次のようにcurlコマンドを使用します以下の例に示されています。

curl --user username -X POST -H 'Content-Type: application/json' -d '{"category": "streaminganalytics", "key": "applicationAccess", "value": "role"}' -k https://mytenant/tenant/options

ここで、ユーザー名を「オプション管理」の ADMIN 権限を持つユーザーの名前に置き換える必要があります。

これは、ストリーミング分析アプリケーションのカードとページの表示設定にのみ影響することに注意してください。サポートされている REST サービスには、「CEP 管理」の READ 権限と ADMIN 権限のみが必要です。

ストリーミング分析アプリケーションのホーム画面のカスタマイズ

ストリーミング分析アプリケーションのホーム画面に表示されるカードには、テキストとリンクが含まれていますこれは、テナントごと、言語ごとにカスタマイズできます。これを行うには、documentation.json ファイルをダウンロードします。 URL /service/cep/apamacorrelator/EN/documentation.json からカスタマイズしたい言語を選択します。 (これは、Things Cloud テナントのユーザーに対して認証される必要があります)。 URL 内の「EN」を次の文字に置き換えます。ダウンロードするファイルの言語コード。

documentation.json ファイルには、ストリーミング分析アプリケーション全体のドキュメントリンクの URL が含まれていますホーム画面に表示されるテキスト。これを要件に合わせて変更できます。

必要な変更をすべて行った後、変更したコピーを次のファイルを含む zipファイルにパッケージ化します。

files/support/cumulocity/EN/documentation.json
cumulocity.json

ここで、cumulocity.json ファイルには以下が含まれます。

{
   "contextPath": "streaminganalytics-customization",
   "availability": "MARKET",
   "type": "HOSTED",
   "name": "streaminganalytics-customization",
   "key": "streaminganalytics-customization-key",
   "noAppSwitcher": true
}

次に、管理アプリケーションを使用して zip ファイルをアップロードします。エコシステム > アプリケーション に移動し、アプリケーションの追加 をクリックし、Web アプリケーションのアップロード メソッドを選択します。詳細については、ユーザーガイド の管理 > アプリケーションの管理をご覧ください。

変更を有効にするには、ブラウザのキャッシュをクリアする必要がある場合があります。

必要に応じて、単一の zip ファイルに複数の言語を含めることができます。必要に応じて、これを親テナントからサブテナントにサブスクライブできます。

プラットフォームの新しいリリースでは、ソースの documentation.json ファイルに変更がないか確認することをお勧めします。このファイル内の新しいエントリは、デフォルト値で選択されます。