/ /

Ops Manager サーバーログのダウンロード

このエンドポイントを使用して、指定されたジョブについて MongoDB Ops Manager が収集したすべてのログファイルを含む .tar.gz アーカイブをダウンロードします。ステータスが IN_PROGRESS または EXPIRED のジョブからはダウンロードできません。ジョブが部分的に失敗した場合、アーカイブには Ops Manager が正常に収集されたログファイルのみが含まれます。

ベース URL: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0

Resource

GET /admin/omLogCollectionJobs/{JOB-ID}:download

必須のロール

このエンドポイントを呼び出す APIキーに Global Read Onlyロールが必要です。

Request Parameters

リクエストパスパラメーター

名前	タイプ	必要性	説明
`JOB-ID`	string	必須	24Ops Managerサーバーログコレクションジョブを識別する一意の桁の 16 進数文字列。ジョブIDを見つけるには、「すべての Ops Manager サーバーログコレクションジョブの取得」を呼び出します。

リクエストクエリパラメータ

次のクエリパラメータは任意です。

名前

タイプ

必要性

説明

default

pretty

ブール値

任意

レスポンス本体を pretty-print 形式にするかどうかを示すフラグ。

false

envelope

ブール値

任意

応答をエンベロープでラップするかどうかを示すフラグ。

一部のAPIクライアントは、 HTTPレスポンスヘッダーまたはステータスコードにアクセスできません。これを修正するには、クエリでenvelope=trueを設定します。

1 つの結果を返すエンドポイントの場合、レスポンス本体には次のものが含まれます。

名前	説明
`status`	HTTPレスポンスコード
`content`	期待される応答本体

false

リクエストボディパラメータ

このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。

応答

このエンドポイントは、Content-Type: application/gzip とファイル名形式om-logs_{timestamp}.tar.gz を含むバイナリストリームを返します。このアーカイブでは、次のレイテンシが使用されています。

om-server-1.example.com/
   application/
      mms0.log
      mms0.20260412.log
   http_access/
      mms0-access.log
   migration/
      mms-migration.log
om-server-2.example.com/
   application/
      mms0.log
   http_access/
      mms0-access.log
      mms0-access.20260412.log

重要

curl を使用してこのエンドポイントを呼び出す場合は、--output とファイル名を渡す必要があります。それ以外の場合、curl はバイナリアーカイブをターミナルに書込みます。

リクエストの例

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Accept: application/gzip" \
     --output om-logs.tar.gz \
     --request GET \
     "https://<OpsManagerHost>:<Port>/api/public/v1.0/admin/omLogCollectionJobs/{JOB-ID}:download"

応答例

応答ヘッダー

HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive

HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/gzip
Content-Disposition: attachment; filename="om-logs_{timestamp}.tar.gz"
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}

レスポンス本体

このエンドポイントは、 JSONレスポンス本体を返しません。

戻る

1 つのジョブを取得

有効期限の延長