マーケットプレイス

マーケットプレイス

Datadog Marketplace は、Datadog テクノロジーパートナーが Datadog ユーザーにインテグレーション、ソフトウェア、サービスを出品できるデジタルマーケットプレイスです。

Datadog Marketplace に参加する前に、まず Datadog パートナーネットワークテクノロジートラックに参加する必要があります。Datadog テクノロジーパートナーとして、インテグレーションを開発し、商品を含むタイルリストを作成できます。

Datadog のお客様は、インテグレーションページまたは Datadog Marketplace のいずれかを介して、Datadog アプリからタイルにアクセスできます。インテグレーションページには、Datadog とテクノロジーパートナーによって無料で構築されたインテグレーションが含まれていますが、Marketplace は、Datadog のお客様とテクノロジーパートナーがインテグレーション、ソフトウェア、サービスなどのさまざまな製品を売買するための商用プラットフォームです。

次の手順に従って、Marketplace の製品を開発および公開します。

サンドボックスアカウントを申請する

すべてのテクノロジーパートナーは、開発を支援するために専用のサンドボックス Datadog アカウントをリクエストできます。サンドボックスをリクエストするには

  1. テクノロジーパートナーアプリケーションと同じメールアドレスを使用して、無料の Datadog トライアルアカウントを作成します
  2. Datadog パートナーポータルにログインします
  3. 個人のホームページで、“Sandbox Access” の下にある “Learn More” ボタンをクリックします。
  4. “Request Sandbox Upgrade” を選択します

アカウントを開発者サンドボックスに変換するには、最大 1〜2 営業日かかる場合があります。ご不明な点がございましたら、Datadog サポートまでお問い合わせください。

インテグレーションを開発する

リソース

このドキュメントに加えて、次の手順を実行することで、Datadog インテグレーションの開発について詳しく知ることができます。

開発プロセス

  1. 出品したい Marketplace 製品のタイプを選択します
  2. 双方向のインテグレーションを構築します
  3. Marketplace リポジトリを複製するか、Integrations Extras リポジトリをフォークします
  4. Datadog Development Toolkit をインストールします
  5. タイルスキャフォールディングにメタデータとすぐに使用できるアセット (ダッシュボードやモニターなど) を入力します
  6. プルリクエストを送信します
  7. タイルのリリースを承認します

1. インテグレーションタイプを選択します

Datadog とインテグレーションする方法はいくつかあります。ユースケースとインテグレーションのタイプに応じて、提供するサービスに最も適したアプローチを選択してください。

1. Datadog Agent ベースインテグレーション

OpenMetrics チェック
  • OpenMetrics チェックは、Open Metrics 標準を使用してメトリクスを公開する既存のアプリケーションからテレメトリデータを収集するのに適しています。
Python チェック
  • Python チェックは、標準形式でメトリクスを公開しないサービスまたは製品の監視に適しています。Python チェックは、さまざまな API またはコマンドラインツールからテレメトリデータを収集するために使用されます。
DogStatsD
  • DogStatsD は、StatsD プロトコルを使用してテレメトリをすでに送信しているアプリケーションに適しています。Datadog は、以下を含む追加の Datadog 固有の拡張機能を StatsD プロトコルに追加します。
    • ヒストグラムメトリクスタイプ
    • サービスのチェック
    • イベント
    • タグ付け

2. Datadog REST API インテグレーション

API インテグレーションは、バックエンドからデータを強化して送信したり、Datadog から直接データをプルしたりするのに適しています。API インテグレーションは、Datadog と別の SaaS プラットフォーム間のコネクタを構築する場合にもうまく機能します。

Note: Datadog API エンドポイントにデータを送信するには Datadog API キーが必要ですが、Datadog からデータをクエリしたり、Datadog アプリ内でリソースを作成したりするにはアプリキーが必要です。

3. タイルのみの出品

データ交換のないスタンドアロンの SaaS またはサービス製品を含む Marketplace 製品の場合、必要なのはタイルのみです。Development Toolkit は、タイルのみのスキャフォールディングを作成するためのコマンドオプション ddev create -t tile "<Offering Name>" を提供します。

2. 双方向のインテグレーションを構築する

Datadog から情報をプルすることも役立つ場合がありますが、Datadog Integrations ページまたは Marketplace に出品するには、インテグレーションが双方向である必要があります。つまり、データを Datadog にプッシュする必要もあります。

インテグレーションにより、次のデータを Datadog に送信できます。

  1. メトリクス
  2. ログ
  3. イベント
  4. サービスチェック
  5. トレース
  6. インシデント
  7. セキュリティイベント

3. Marketplace リポジトリを複製するか、Integrations Extras リポジトリをフォークします

Datadog インテグレーションは、非公開の Marketplace リポジトリまたはオープンソースの Integrations Extras リポジトリのいずれか用に開発できます。

インテグレーションを構築するプロセスは各リポジトリで同じですが、Marketplace 製品にはさらにいくつかのファイルとフィールド (価格設定など) が必要です。プルリクエストを複製して送信するときは、目的のリポジトリを指すことを忘れないでください。

テクノロジーパートナーは、marketplace@datadog.com にメールを送信することにより、非公開の Marketplace リポジトリへのアクセスをリクエストできます。

4. Datadog Development Toolkit をインストールして実行します

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\]

次の場所を複製されたリポジトリに設定します。

Marketplace:

ddev config set marketplace /path/to/marketplace_directory
ddev config set repo marketplace

Integrations-Extras:

ddev 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>"

5. タイルスキャフォールディングにデータを入力します

前のセクションの ddev コマンドは、タイルアセットを構成するフォルダーとファイルのスケルトンを生成します。

README.md

  • “Overview”、“Setup”、“Support” セクションを H2 見出し (マークダウンの ##) で含めます。
  • “Overview" の見出しは、製品がユーザーに提供する価値と、より包括的な可観測性のために Datadog と一緒に使用する方法を明確に説明する必要があります。ソフトウェアまたはダッシュボードの動作中の画像を追加することをお勧めします。このセクションは、タイルの “Overview” タブに表示されます。
  • “Setup” の見出しは、ユーザーが製品をインストールまたは使用するための簡単なコンフィギュレーション手順を提供する必要があります。このセクションは、タイルの “Configuration” タブに表示されます。
  • “Support” の見出しは、サポートの連絡先を特定し、場合によっては製品のフィードバックを送信するオプションを特定する必要があります。このセクションは、タイルの “Support” タブに表示されます。

画像

  • README.md ファイルで使用されているすべての画像を images フォルダに保存します。
  • 注: 画像ファイル名にはスペースを含めないようにしてください。

Manifest.json

Metadata.csv

  • メトリクス名、タイプ、間隔、単位など、インテグレーションに含まれるすぐに使用できるメトリクスのリストが含まれています。
  • metadata.csv フィールドの詳細については、インテグレーションアセットリファレンスを参照してください。
  • 注: すべての Marketplace メトリクスは、カスタムメトリクスとしてカウントされます。

ダッシュボードとモニター

  • インテグレーション用のすぐに使用できるダッシュボードとモニター (アラート) が含まれています。
  • サンドボックスアカウントでダッシュボードとモニターを直接作成し、JSON ファイルとしてエクスポートできます。
  • 詳細については、ダッシュボードのベストプラクティスドキュメントを参照してください。

ロゴ

  • DesignOps チームが Datadog アプリ全体にライトモードとダークモードの両方で実装する SVG で構成されています。ロゴの SVG ファイルは assets ディレクトリに追加するか、assets 下の logos サブディレクトリに配置することができます。
  • 注: テクノロジーパートナーは、提出するロゴのライセンスに責任を負います。

Changelog.md

  • リリースノートとバージョン情報をキャプチャし、タイルの “Release Notes” タブに表示します。リリースノートを降順で追加します (最新バージョンが上部)。

コードオーナー

  • 共有された .github ディレクトリでリポジトリ内のコードに責任を持つ個人またはチームのことを指します。構文についてのヘルプはGithub のドキュメントを参照してください。

追加の Marketplace ファイル

  • すべての Marketplace 製品には、テクノロジーパートナー独自のエンドユーザー使用許諾契約 (EULA) が必要です。

6. プルリクエストを送信します

インテグレーションアセットを含むプルリクエストを Marketplace リポジトリまたは Integrations Extras リポジトリに送信します。

各リポジトリは自動テストを実行して、プルリクエストが良好な状態であることを確認します。コマンド ddev validate all を使用して、これらの同じテストをローカルで実行できます。PR がすべてのチェックに合格すると、エンジニアリングチームがレビューを開始し、リリースするブロッカーを特定し、ベストプラクティスに関する提案を行います。

Marketplace リポジトリの Azure DevOps にアクセスする必要がある場合は、PR にコメントを残してください。エンジニアリングチームがアクセスを提供します。

7. タイルのリリースを承認します

プルリクエストタイルがエンジニアリングチームと製品チームによって承認されると、サンドボックスアカウントでタイルが有効になります。これにより、Datadog Marketplace でインテグレーションタイルを検証および表示し、公開前に変更を加えることができます。

市場開拓の機会を調整する

公式の双方向インテグレーションが開始されると、テクノロジーパートナーは、Datadog のパートナーマーケティングチームと会って、次のような共同の市場開拓戦略を調整することができます。

  • パートナーのプレスリリースの Datadog 見積もり
  • Datadog モニター内のブログ記事
  • パートナーウェビナーの Datadog スピーカー
  • ソーシャルメディア投稿の増幅

お問い合わせ

ご不明な点がございましたら、techpartners@datadoghq.com までお問い合わせください。

その他の参考資料