機械翻訳について

ジャンプ先

• 要求
• レスポンス
• 例

ランタイム統計の取得

get

/essbase/rest/v1/applications/{applicationName}/databases/{databaseName}/statistics/runtime

指定されたデータベースの実行時統計を返します。

要求

パス・パラメータ

• applicationName: string

  アプリケーション名

• databaseName: string

  データベース名

先頭に戻る

レスポンス

サポートされるメディア・タイプ

• application/json
• application/xml

200 レスポンス

OK

データベース・ランタイム統計が正常に返されました。

本文()

ルート・スキーマ : RuntimeStatistics

タイプ: object

アプリケーションのランタイム・ストレージ統計

Show Source

• cacheHitRatio(optional): number(double)

  ハード・ディスクからではなく、集約ストレージ・キャッシュから応答されたリクエスト数の比率。 パラレル・データ・ロードまたはパラレル計算操作が使用されている場合、正確でない可能性があります。

• currentCacheSize(optional): number(double)

  集約ストレージ・キャッシュの現在のサイズ。 currentCacheSizeLimitも参照してください。

• currentCacheSizeLimit(optional): number(double)

  集約ストレージ・キャッシュの最大サイズ(キロバイト)。

• diskSpaceAllocatedForData(optional): number(double)

  集約ストレージ・キューブの場合、デフォルト表領域のすべてのディスク・ファイルで使用される合計領域。

• diskSpaceUsedByData(optional): number(double)

  集約ストレージ・キューブの場合、デフォルト表領域のディスク・ファイル内で実際に使用されている合計領域(ファイル内の一部の領域は空いている可能性があります)。

• hitRatioOnDataCache(optional): number(double)
• hitRatioOnDataFileCache(optional): number(double)
• hitRatioOnIndexCache(optional): number(double)
• numberOfDataBlockReads(optional): number(double)
• numberOfDataBlockWrites(optional): number(double)
• numberOfIndexPageReads(optional): number(double)
• numberOfIndexPageWrites(optional): number(double)
• pageReadsSinceLastStartup(optional): number(double)

  集約ストレージ・キューブの場合、アプリケーションが最後に起動されてからディスクから読み取られたデータ・ページの数。

• pageSize(optional): number(double)

  集約ストレージ・キューブの場合、データ・ページのサイズ(メガバイト)。

• pageWritesSinceLastStartup(optional): number(double)

  集約ストレージ・キューブの場合、アプリケーションが最後に起動されてからディスクに書き込まれたデータ・ページの数。

• temporaryDiskSpaceAllocated(optional): number(double)

  集約ストレージ・キューブの場合、一時表領域内のすべてのディスク・ファイルによって使用される合計領域。

• temporaryDiskSpaceUsed(optional): number(double)

  集約ストレージ・キューブの場合、一時表領域のディスク・ファイル内で実際に使用されている合計領域(ファイル内の一部の領域は空いている可能性があります)。

{
    "type":"object",
    "description":"<p>Runtime storage statistics for an application</p>",
    "properties":{
        "cacheHitRatio":{
            "type":"number",
            "description":"<p>Ratio of the number of requests answered from aggregate storage cache as opposed to from the hard disk. May not be accurate when parallel data load or parallel calculation operations are in use.</p>",
            "format":"double"
        },
        "currentCacheSize":{
            "type":"number",
            "description":"<p>The current size of the aggregate storage cache. See also currentCacheSizeLimit.</p>",
            "format":"double"
        },
        "currentCacheSizeLimit":{
            "type":"number",
            "description":"<p>The maximum size (in kilobytes) to which the aggregate storage cache may grow.</p>",
            "format":"double"
        },
        "pageReadsSinceLastStartup":{
            "type":"number",
            "description":"<p>For an aggregate storage cube, number of data pages read from disk since the last time the application was started.</p>",
            "format":"double"
        },
        "pageWritesSinceLastStartup":{
            "type":"number",
            "description":"<p>For an aggregate storage cube, number of data pages written to disk since the last time the application was started.</p>",
            "format":"double"
        },
        "pageSize":{
            "type":"number",
            "description":"<p>For an aggregate storage cube, size of the data page in kilobytes.</p>",
            "format":"double"
        },
        "diskSpaceAllocatedForData":{
            "type":"number",
            "description":"<p>For an aggregate storage cube, total space used by all disk files in the default tablespace.</p>",
            "format":"double"
        },
        "diskSpaceUsedByData":{
            "type":"number",
            "description":"<p>For an aggregate storage cube, total space actually in use within the disk files in the default tablespace (some space within files may be free).</p>",
            "format":"double"
        },
        "temporaryDiskSpaceAllocated":{
            "type":"number",
            "description":"<p>For an aggregate storage cube, total space used by all disk files in the temp tablespace.</p>",
            "format":"double"
        },
        "temporaryDiskSpaceUsed":{
            "type":"number",
            "description":"<p>For an aggregate storage cube, total space actually in use within the disk files in the temp tablespace (some space within files may be free).</p>",
            "format":"double"
        },
        "hitRatioOnIndexCache":{
            "type":"number",
            "format":"double"
        },
        "hitRatioOnDataCache":{
            "type":"number",
            "format":"double"
        },
        "numberOfIndexPageReads":{
            "type":"number",
            "format":"double"
        },
        "numberOfIndexPageWrites":{
            "type":"number",
            "format":"double"
        },
        "numberOfDataBlockReads":{
            "type":"number",
            "format":"double"
        },
        "numberOfDataBlockWrites":{
            "type":"number",
            "format":"double"
        },
        "hitRatioOnDataFileCache":{
            "type":"number",
            "format":"double"
        }
    }
}

400 レスポンス

不正なリクエスト

データベース・ランタイム統計の取得に失敗しました。 アプリケーション名またはデータベース名が正しくない可能性があります。

500 レスポンス

内部サーバー・エラー。

先頭に戻る

例

次の例では、cURLを使用してWindowsシェル・スクリプトからREST APIにアクセスし、キューブの実行時統計を取得する方法を示します。

コール元のユーザーIDおよびパスワードは、properties.batで値が設定される変数です。

cURLコマンドを含むスクリプト

call properties.bat
curl -X GET "https://192.0.2.1:443/essbase/rest/v1/applications/Sample_Dynamic/databases/Basic/statistics/runtime"
     -H  "accept: application/json"
     -u %User%:%Password

レスポンス本体の例

{
  "runtime": {
    "cacheHitRatio": 0,
    "currentCacheSize": 0,
    "currentCacheSizeLimit": 0,
    "pageReadsSinceLastStartup": 0,
    "pageWritesSinceLastStartup": 0,
    "pageSize": 0,
    "diskSpaceAllocatedForData": 0,
    "diskSpaceUsedByData": 0,
    "temporaryDiskSpaceAllocated": 0,
    "temporaryDiskSpaceUsed": 0,
    "hitRatioOnIndexCache": 0,
    "hitRatioOnDataCache": 0,
    "numberOfIndexPageReads": 0,
    "numberOfIndexPageWrites": 0,
    "numberOfDataBlockReads": 0,
    "numberOfDataBlockWrites": 0,
    "hitRatioOnDataFileCache": 0
  }
}

先頭に戻る