Datadog Marketplace は、Datadog テクノロジーパートナーが Datadog ユーザーにインテグレーション、ソフトウェア、サービスを出品できるデジタルマーケットプレイスです。
Datadog Marketplace に参加する前に、まず Datadog パートナーネットワークテクノロジートラックに参加する必要があります。Datadog テクノロジーパートナーとして、インテグレーションを開発し、商品を含むタイルリストを作成できます。
Datadog のお客様は、インテグレーションページまたは Datadog Marketplace のいずれかを介して、Datadog アプリからタイルにアクセスできます。インテグレーションページには、Datadog とテクノロジーパートナーによって無料で構築されたインテグレーションが含まれていますが、Marketplace は、Datadog のお客様とテクノロジーパートナーがインテグレーション、ソフトウェア、サービスなどのさまざまな製品を売買するための商用プラットフォームです。
次の手順に従って、Marketplace の製品を開発および公開します。
すべてのテクノロジーパートナーは、開発を支援するために専用のサンドボックス Datadog アカウントをリクエストできます。サンドボックスをリクエストするには
アカウントを開発者サンドボックスに変換するには、最大 1〜2 営業日かかる場合があります。ご不明な点がございましたら、Datadog サポートまでお問い合わせください。
このドキュメントに加えて、次の手順を実行することで、Datadog インテグレーションの開発について詳しく知ることができます。
Datadog とインテグレーションする方法はいくつかあります。ユースケースとインテグレーションのタイプに応じて、提供するサービスに最も適したアプローチを選択してください。
API インテグレーションは、バックエンドからデータを強化して送信したり、Datadog から直接データをプルしたりするのに適しています。API インテグレーションは、Datadog と別の SaaS プラットフォーム間のコネクタを構築する場合にもうまく機能します。
Note: Datadog API エンドポイントにデータを送信するには Datadog API キーが必要ですが、Datadog からデータをクエリしたり、Datadog アプリ内でリソースを作成したりするにはアプリキーが必要です。
データ交換のないスタンドアロンの SaaS またはサービス製品を含む Marketplace 製品の場合、必要なのはタイルのみです。Development Toolkit は、タイルのみのスキャフォールディングを作成するためのコマンドオプション ddev create -t tile "<Offering Name>" を提供します。
Datadog から情報をプルすることも役立つ場合がありますが、Datadog Integrations ページまたは Marketplace に出品するには、インテグレーションが双方向である必要があります。つまり、データを Datadog にプッシュする必要もあります。
インテグレーションにより、次のデータを Datadog に送信できます。
Datadog インテグレーションは、非公開の Marketplace リポジトリまたはオープンソースの integrations-extras リポジトリのいずれか用に開発できます。
インテグレーションを構築するプロセスは各リポジトリで同じですが、Marketplace 製品にはさらにいくつかのファイルとフィールド (価格設定など) が必要です。プルリクエストを複製して送信するときは、目的のリポジトリを指すことを忘れないでください。
テクノロジーパートナーは、marketplace@datadog.com にメールを送信することにより、非公開の Marketplace リポジトリへのアクセスをリクエストできます。
Datadog Development Toolkit コマンド (ddev) を使用すると、タイルのすべてのアセットとメタデータのスケルトンをスピンアップすることで、インテグレーションを最初に開発するときにスキャフォールディングを作成できます。
Python 3.8 以降がインストールされていることを確認します。
潜在的な環境の競合を防ぐために、リポジトリを複製したディレクトリで次を実行して仮想環境を作成します。
python3 -m pip install virtualenv --user
次を実行して、PyPI から Datadog Development Toolkit の最新バージョンをインストールします。
python -m pip install --upgrade "datadog-checks-dev[cli]"
注: Z シェルを使用している場合は、エスケープ文字を使用する必要があります。
python -m pip install --upgrade datadog-checks-dev\[cli\]
次の場所を複製されたリポジトリに設定します。
ddev config set marketplace /path/to/marketplace_directory
ddev config set repo marketplace
integrations-extrasddev config set extras /path/to/integrations-extras_directory
ddev config set repo extras
スタンドアロンのソフトウェアとサービスの場合、またはインテグレーションが Datadog API を使用していて、Python コードが含まれていない場合、Development Toolkit はタイルのみのコマンドをサポートします。
上記で指定した marketplace または integrations-extras ディレクトリで以下を実行します。
ddev create -t tile "<Offering Name>"
インテグレーションの完全なスキャフォールディングを生成するには、上記で指定した marketplace または integrations-extras ディレクトリから以下を実行します。
ddev create "<Offering Name>"
前のセクションの ddev コマンドは、タイルアセットを構成するフォルダーとファイルのスケルトンを生成します。
README.md ファイルで使用されているすべての画像を images フォルダに保存します。display_name、public_title、author などの要素を含む JSON オブジェクト。manifest.json フィールドの詳細については、インテグレーションアセットリファレンスを参照してください。metadata.csv フィールドの詳細については、インテグレーションアセットリファレンスを参照してください。assets ディレクトリに追加するか、assets 下の logos サブディレクトリに配置することができます。.github ディレクトリでリポジトリ内のコードに責任を持つ個人またはチームのことを指します。構文についてのヘルプはGithub のドキュメントを参照してください。インテグレーションアセットを含むプルリクエストを Marketplace リポジトリまたは Integrations Extras リポジトリに送信します。
各リポジトリは自動テストを実行して、プルリクエストが良好な状態であることを確認します。コマンド ddev validate all を使用して、これらの同じテストをローカルで実行できます。PR がすべてのチェックに合格すると、エンジニアリングチームがレビューを開始し、リリースするブロッカーを特定し、ベストプラクティスに関する提案を行います。
Marketplace リポジトリの Azure DevOps にアクセスする必要がある場合は、PR にコメントを残してください。エンジニアリングチームがアクセスを提供します。
プルリクエストタイルがエンジニアリングチームと製品チームによって承認されると、サンドボックスアカウントでタイルが有効になります。これにより、Datadog Marketplace でインテグレーションタイルを検証および表示し、公開前に変更を加えることができます。
公式の双方向インテグレーションが開始されると、テクノロジーパートナーは、Datadog のパートナーマーケティングチームと会って、次のような共同の市場開拓戦略を調整することができます。
ご不明な点がございましたら、techpartners@datadoghq.com までお問い合わせください。
お役に立つドキュメント、リンクや記事:
