ペイロード・ロギング | IBM Cloud Pak for Data as a Service

資料の英語版に戻る

ペイロード・ロギング

最終更新: 2024年10月25日

ペイロード・ロギング

ペイロードロギングを有効にして、モデル評価を設定することができます。

公平性やドリフト評価、説明可能性を設定するためにペイロードデータを管理するには、データマートにペイロードデータを記録する必要があります。評価のためにデプロイメントを追加したり、モデルの詳細を提供したりすると、必要なモデルの詳細がすべて検出された場合に、モデルのトランザクションを記録するためのスコアリング要求を自動的に送信することができます。必要なモデルの詳細がすべて検出されない場合、または画像や構造化されていないテキストモデルを評価している場合は、手動でペイロードロギングを有効にする必要があります。

手動ペイロード・ロギング

ペイロード・ロギングを有効にするには、ペイロード・ロギング API または JSON ファイルを使用して、評価要求を送信します。ペイロードロギングAPIを使用する場合、cURLまたはPythonSDKでスコアリングリクエストを送信することができます。

Python SDK を使用したペイロード・ロギング

以下の例のように、PythonSDKを使って採点リクエストを送信することができます：

from ibm_cloud_sdk_core.authenticators import IAMAuthenticator
from ibm_watson_openscale import APIClient

service_credentials = {
                  "apikey": "*****",
                  "url": "https://api.aiopenscale.cloud.ibm.com"
               }

authenticator = IAMAuthenticator(
        apikey=service_credentials['apikey']
    )
client = APIClient(
    service_url=service_credentials['url'],
    service_instance_id="230a8e9f-2453-4c2d-a560-2a75399210bf"
    authenticator=authenticator
)

from ibm_watson_openscale.data_sets import DataSetTypes, TargetTypes

# Put your subscription ID here
SUBSCRIPTION_ID = "<subscription_id>"
payload_logging_data_set_id = wos_client.data_sets.list(type=DataSetTypes.PAYLOAD_LOGGING, target_target_id=SUBSCRIPTION_ID, target_target_type=TargetTypes.SUBSCRIPTION).result.data_sets[0].metadata.id

from ibm_watson_openscale.supporting_classes.payload_record import PayloadRecord

# Put your scoring ID here
SCORING_ID = "<scoring_id>"
REQUEST_DATA = <put_your_data_here>
RESPONSE_DATA = <put_your_data_here>
wos_client.data_sets.store_records(data_set_id=payload_logging_data_set_id, request_body=[PayloadRecord(scoring_id=SCORING_ID, request=REQUEST_DATA, response=RESPONSE_DATA, response_time=460)])

cURL を使用したペイロード・ロギング

以下の cURL コマンドを使用して、スコアリング要求を送信できます。

curl -k -X POST https://$ICP_HOSTNAME:$PORT/openscale/00000000-0000-0000-0000-000000000000/v2/data_sets/<dataset_id>/records -d "$SCORING_PAYLOAD" \
--header 'Content-Type: application/json' --header 'Accept: application/json' --header "Authorization: Bearer $ICP_TOKEN"

詳細はAPIを参照。

JSON を使用したペイロード・ロギング

以下の例に示すように、JSON を使用して評価要求を送信できます。

[
  {
    "request": {
      "fields": [
        "AGE",
        "BP",
        "CHOLESTEROL",
        "NA",
        "K"
      ],
      "values": [
        [
          28,
          "LOW",
          "HIGH",
          0.61,
          0.026
        ]
      ],
      "meta": {
        "fields": [
          "SEX"
        ],
        "values": [
          [
            "M"
          ]
        ]
      }
    },
    "response": {
      "fields": [
        "AGE",
        "BP",
        "CHOLESTEROL",
        "NA",
        "K",
        "probability",
        "prediction",
        "predictedLabel"
      ],
      "values": [
        [
          28,
          "LOW",
          "HIGH",
          0.61,
          0.026,
          [
            0.82,
            0.07,
            0,
            0.05,
            0.03
          ],
          0,
          "drugY"
        ]
      ]
    }
  }
]

親トピック: Watson OpenScale