New Relic では、NerdGraph を使用して証明書チェック モニターを作成できます。証明書チェック モニターは SSL 証明書の有効期限を追跡し、証明書の有効期限が近づくと通知します。 このチュートリアルでは、NerdGraph API を使用して証明書チェック モニターの作成を自動化する方法の例を示します。
証明書チェックモニターを作成する
syntheticsCreateCertCheckMonitorミューテーションを使用して証明書チェック モニターを作成できます。この変更により、任意のドメインで SSL 証明書の有効期限の監視を設定できるようになります。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 整数 | はい | モニターが作成される New Relic 。 |
| 弦 | はい | 証明書の有効期限を監視するドメイン (例:
)。 |
| 配列 | はい | モニターがチェックを実行する 識別子の配列 (例:
)。 |
| 弦 | はい | 証明書チェック モニターの表示名。 |
| 整数 | はい | 証明書の有効期限が切れる前に失敗をトリガーする日数。たとえば、これを 30 に設定すると、証明書の有効期限が 30 日以内の場合にモニターが失敗することを意味します。 |
| イナム | はい | モニターが実行される頻度。オプション:
、
、
、
、
、
、
、
、
。 |
| イナム | はい | モニターのステータス。オプション:
(モニターはアクティブでチェックを実行中)、
(モニターは非アクティブ)。 |
| 浮く | いいえ | SLA レポートの入力に使用される、モニターの Apdex ターゲット (秒単位)。デフォルトは 7.0 秒です。 |
サンプルリクエスト
mutation { syntheticsCreateCertCheckMonitor( accountId: ACCOUNT_ID monitor: { domain: "DOMAIN" locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "YOUR_MONITOR_NAME" numberDaysToFailBeforeCertExpires: DAYS_UNTIL_EXPIRATION period: PERIOD status: STATUS apdexTarget: APDEX_TARGET } ) { errors { description type } }}サンプル回答
成功した応答はエラーに対してnullを返します:
{ "data": { "syntheticsCreateCertCheckMonitor": { "errors": null } }}モニターの作成中に問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionとtypeフィールドを持つオブジェクトが含まれます。
証明書チェックモニターを更新します
syntheticsUpdateCertCheckMonitorミューテーションを使用して、既存の証明書チェック モニターを更新できます。これにより、すでに作成されている証明書チェックモニターの設定を変更できます。
入力
パラメータ | データタイプ | 必須ですか? | 説明 |
|---|---|---|---|
| 弦 | はい | 更新するモニターの一意のエンティティ 。 |
| 弦 | いいえ | 証明書の有効期限を監視するドメイン (例:
)。 |
| 配列 | いいえ | モニターがチェックを実行する 識別子の配列 (例:
)。 |
| 弦 | いいえ | 証明書チェック モニターの更新された表示名。 |
| 整数 | いいえ | 証明書の有効期限が切れる前に失敗をトリガーする日数。 |
| イナム | いいえ | モニターが実行される頻度。オプション:
、
、
、
、
、
、
、
、
。 |
| イナム | いいえ | モニターのステータス。オプション:
(モニターはアクティブでチェックを実行中)、
(モニターは非アクティブ)。 |
| 浮く | いいえ | SLA レポートの入力に使用される、モニターの Apdex ターゲット (秒単位)。デフォルトは 7.0 秒です。 |
サンプルリクエスト
mutation { syntheticsUpdateCertCheckMonitor( guid: ENTITY_GUID monitor: { domain: "DOMAIN" locations: { public: ["LOCATION_1", "LOCATION_2"] } name: "YOUR_MONITOR_NAME" numberDaysToFailBeforeCertExpires: DAYS_UNTIL_EXPIRATION period: PERIOD status: STATUS apdexTarget: APDEX_TARGET } ) { errors { description type } }}サンプル回答
成功した応答はエラーに対してnullを返します:
{ "data": { "syntheticsUpdateCertCheckMonitor": { "errors": null } }}モニターの更新中に問題が発生した場合、 errors配列には、何が問題であったかを説明するdescriptionとtypeフィールドを持つオブジェクトが含まれます。
証明書チェックモニターを削除する
証明書チェックモニターが不要になった場合は、 syntheticsDeleteMonitorミューテーションを使用してそれを完全に削除できます。
モニターを削除するには、 「合成モニターの削除」セクションを参照してください。