doc: Add xgboost doc on bring your own model #1727

edwardjkim · 2020-07-20T18:00:38Z

Description of changes:

This CR adds a section on how to deploy an inference server with an XGBoost model that was trained outside SageMaker.

Merge Checklist

Put an x in the boxes that apply. You can also fill these out after creating the PR. If you're unsure about any of them, don't hesitate to ask. We're here to help! This is simply a reminder of what we are going to look for before merging your pull request.

General

I have read the CONTRIBUTING doc
I used the commit message format described in CONTRIBUTING
I have passed the region in to all S3 and STS clients that I've initialized as part of this change.
I have updated any necessary documentation, including READMEs and API docs (if appropriate)

Tests

I have added tests that prove my fix is effective or that my feature works (if appropriate)
I have checked that my tests are not configured for a specific region or account (if appropriate)
I have used unique_name_from_base to create resource names in integ tests (if appropriate)

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

sagemaker-bot · 2020-07-20T18:05:44Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-unit-tests
Commit ID: ced1399
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-20T18:27:13Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-unit-tests
Commit ID: da03d7f
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-20T18:28:13Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-notebook-tests
Commit ID: ced1399
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-20T18:46:33Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-notebook-tests
Commit ID: da03d7f
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-20T18:54:12Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-pr
Commit ID: da03d7f
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-20T19:01:48Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: ced1399
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-20T19:17:59Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: da03d7f
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-20T23:04:40Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-unit-tests
Commit ID: d6005a8
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-20T23:21:53Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-notebook-tests
Commit ID: d6005a8
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-20T23:27:17Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-pr
Commit ID: d6005a8
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-20T23:54:40Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: d6005a8
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

edwardjkim · 2020-07-21T18:48:12Z

@metrizable Can you please review?

laurenyu · 2020-07-22T18:06:31Z

doc/frameworks/xgboost/using_xgboost.rst

+For a sample notebook that shows to use the XGBoost built-in algorith mode to load a pre-existing XGBoost model,
+see `Amazon SageMaker XGBoost Bring Your Own Model <https://github.com/awslabs/amazon-sagemaker-examples/blob/master/advanced_functionality/xgboost_bring_your_own_model/xgboost_bring_your_own_model.ipynb>`_.


typo with "algorithm". also, would it make more sense to put this in the "Use XGBoost as a Built-in Algorithm" section?

Suggested change

For a sample notebook that shows to use the XGBoost built-in algorith mode to load a pre-existing XGBoost model,

see `Amazon SageMaker XGBoost Bring Your Own Model <https://github.com/awslabs/amazon-sagemaker-examples/blob/master/advanced_functionality/xgboost_bring_your_own_model/xgboost_bring_your_own_model.ipynb>`_.

For a sample notebook that shows to use the XGBoost built-in algorithm mode to load a pre-existing XGBoost model,

see `Amazon SageMaker XGBoost Bring Your Own Model <https://github.com/awslabs/amazon-sagemaker-examples/blob/master/advanced_functionality/xgboost_bring_your_own_model/xgboost_bring_your_own_model.ipynb>`_.

Thanks for the suggestion. There will also be a section on AWS documentation, and considering your suggestion, I think it makes more sense to move this to AWS documentation since the notebook is about the built-in mode. Python SDK doc can focus on script mode.

doc/frameworks/xgboost/using_xgboost.rst

Co-authored-by: Lauren Yu <[email protected]>

sagemaker-bot · 2020-07-22T18:49:02Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-unit-tests
Commit ID: 398dd6d
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T18:49:10Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-unit-tests
Commit ID: 9eff097
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T18:49:33Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-unit-tests
Commit ID: a19c99c
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T18:49:52Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-notebook-tests
Commit ID: 973d822
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T18:50:32Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-unit-tests
Commit ID: ac20b3f
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T18:52:10Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-unit-tests
Commit ID: 973d822
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:12:13Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-notebook-tests
Commit ID: 0f8ee0a
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:13:07Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-notebook-tests
Commit ID: ac20b3f
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:15:50Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-notebook-tests
Commit ID: 398dd6d
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:38:14Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-notebook-tests
Commit ID: 973d822
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:43:44Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: 398dd6d
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:43:47Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: 0880512
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:43:58Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: fd7da88
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:44:43Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: fd7da88
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:45:22Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: a19c99c
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:45:40Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-pr
Commit ID: c32de01
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:45:54Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: 9eff097
Result: FAILED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:47:32Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: 0f8ee0a
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:48:13Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: ac20b3f
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:48:33Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: 973d822
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:48:36Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: 973d822
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T19:59:56Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: c32de01
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

laurenyu · 2020-07-22T20:21:31Z

doc/frameworks/xgboost/using_xgboost.rst

+    )
+
+    # If payload is a string in LIBSVM format, we need to change serializer.
+    predictor.serializer = str


what is str supposed to be here?

We've been using serializer = str in our XGBoost notebook examples because the most natural format for XGBoost is libsvm and there is no default libsvm serializer. My understanding is predictor expects a byte sequence like a numpy array by default, so I've been using serializer = str when I have a payload in libsvm string format. Is there a better way (other than writing a custom serializer)?

ah, gotcha. no, the only other way would be to write a custom serializer.

The predictor is an XGBoost model - couldn't we override the default serializer to str for it?

Yes, we could override it here: https://github.com/aws/sagemaker-python-sdk/blob/master/src/sagemaker/xgboost/model.py#L45. But I guess the question is if it's going to break any customers who were assuming a different default.

if it makes sense to change it, you can make another PR against the "zwei" branch - that's where our v2 work is happening right now

Cool, thanks for the pointer! And also for reminding me that our team needs to revisit the xgboost and sklearn estimator before v2 for issues like this.

sagemaker-bot · 2020-07-22T21:42:07Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: 002e75a
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T21:42:07Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-pr
Commit ID: 002e75a
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T21:42:30Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-notebook-tests
Commit ID: 002e75a
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-22T21:51:48Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-unit-tests
Commit ID: 002e75a
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

eslesar-aws

lgtm

sagemaker-bot · 2020-07-29T17:19:02Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-pr
Commit ID: 63c601d
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-29T17:19:03Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-local-mode-tests
Commit ID: 63c601d
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-29T17:19:27Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-notebook-tests
Commit ID: 63c601d
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

sagemaker-bot · 2020-07-29T17:26:42Z

AWS CodeBuild CI Report

CodeBuild project: sagemaker-python-sdk-unit-tests
Commit ID: 63c601d
Result: SUCCEEDED
Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

doc: Add xgboost doc on bring your own model

d6005a8

edwardjkim force-pushed the doc-xgboost-byom branch from da03d7f to d6005a8 Compare July 20, 2020 22:54

laurenyu requested a review from eslesar-aws July 22, 2020 18:04

laurenyu reviewed Jul 22, 2020

View reviewed changes

Kim and others added 8 commits July 22, 2020 11:42

Move reference to BYOM notebook to AWS doc

0880512

Update doc/frameworks/xgboost/using_xgboost.rst

0f8ee0a

Co-authored-by: Lauren Yu <[email protected]>

Update doc/frameworks/xgboost/using_xgboost.rst

fd7da88

Co-authored-by: Lauren Yu <[email protected]>

Update doc/frameworks/xgboost/using_xgboost.rst

398dd6d

Co-authored-by: Lauren Yu <[email protected]>

Update doc/frameworks/xgboost/using_xgboost.rst

9eff097

Co-authored-by: Lauren Yu <[email protected]>

Update doc/frameworks/xgboost/using_xgboost.rst

a19c99c

Co-authored-by: Lauren Yu <[email protected]>

Update doc/frameworks/xgboost/using_xgboost.rst

ac20b3f

Co-authored-by: Lauren Yu <[email protected]>

Update doc/frameworks/xgboost/using_xgboost.rst

973d822

Co-authored-by: Lauren Yu <[email protected]>

laurenyu reviewed Jul 22, 2020

View reviewed changes

Merge branch 'master' into doc-xgboost-byom

002e75a

laurenyu approved these changes Jul 28, 2020

View reviewed changes

eslesar-aws approved these changes Jul 29, 2020

View reviewed changes

Merge branch 'master' into doc-xgboost-byom

63c601d

laurenyu merged commit 043d3eb into aws:master Jul 29, 2020

		For a sample notebook that shows to use the XGBoost built-in algorith mode to load a pre-existing XGBoost model,
		see `Amazon SageMaker XGBoost Bring Your Own Model <https://github.com/awslabs/amazon-sagemaker-examples/blob/master/advanced_functionality/xgboost_bring_your_own_model/xgboost_bring_your_own_model.ipynb>`_.

doc: Add xgboost doc on bring your own model #1727

doc: Add xgboost doc on bring your own model #1727

Conversation

edwardjkim commented Jul 20, 2020

Merge Checklist

General

Tests

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 20, 2020

AWS CodeBuild CI Report

edwardjkim commented Jul 21, 2020

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

sagemaker-bot commented Jul 22, 2020

AWS CodeBuild CI Report

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

edwardjkim Jul 29, 2020 •

edited

Loading