構成ファイルの作成

ノード・エクスポータによって公開されたすべてのメトリックをpoc_prometheusネームスペースにスクレイプするには、構成ファイルを作成し、すべてのメトリック・データポイントのディメンションとしてnodeNameを指定する必要があります。

$ cat /opt/oracle/mgmt_agent/agent_inst/discovery/PrometheusEmitter/nodeVM1-ol7.properties
# property file scraping all metrics of the node_exporter that has been set up on 10.20.30.40
url=http://10.20.30.40:9100/metrics
namespace=poc_prometheus
nodeName=nodeVM1-ol7
metricDimensions=nodeName
allowMetrics=*
compartmentId=ocidl.compartment.ocl..aaaaaaaa...kovd6xlq

ハッシュタグ記号(#)で始まる行はコメントとみなされ、無視されます。

前述の構成ファイルが作成され、検出ディレクトリ /opt/oracle/mgmt_agent/agent_inst/discovery/PrometheusEmitter/に配置されると、管理エージェントによって数分で処理され、メトリックはOCIモニタリング・サービスへのフローを開始します。

メトリックをOCIモニタリングにポストするポリシーの作成

1. 動的グループが作成されたことを確認します。

   ポリシーを作成する前に、必要な動的グループが作成されたことを確認する必要があります。

   たとえば、Management-Agent-Dynamic-Groupという名前の管理エージェント動的グループが、次を使用して作成されていることを確認します:

   ALL {resource.type='managementagent', resource.compartment.id='<AGENT_COMPARTMENT_OCID>'}

   この例では、<AGENT_COMPARTMENT_OCID>はエージェントのコンパートメントOCIDです。

2. 動的グループのIAMポリシーを作成して、管理エージェント・サービスが、以前に作成した構成ファイルからcompartmentIdプロパティを使用して選択したコンパートメントのOCIモニタリング・サービスに収集されたメトリックをポストできるようにします。

   allow dynamic-group Management-Agent-Dynamic-Group to use metrics in compartment <PROMETHEUS_METRIC_COMPARTMENT_NAME> where target.metrics.namespace = 'poc_prometheus'

   • Management-Agent-Dynamic-Groupは、作成された動的グループの名前です。

   • <PROMETHEUS_METRIC_COMPARTMENT_NAME>は、構成ファイルの作成時にcompartmentIdプロパティを使用してOCIDが提供されたコンパートメントの名前です。構成ファイルの作成を参照してください。

     これは、Prometheusメトリックがポストされるコンパートメントです。

   • poc_prometheusはネームスペースであり、構成ファイルの作成時に指定されたnamespace値と一致する必要があります。

エージェントにポリシー変更を適用するには、エージェントを再起動する必要があります。

構成ファイルのプロパティ

この項では、Prometheusエクスポータを使用してメトリックを収集するために使用できる必須プロパティとオプションのプロパティを示します。

必須プロパティ

構成ファイルを作成する場合は、次のプロパティーが必要です。

オプション・プロパティ:

構成ファイルでは、次のオプション・プロパティを使用できます。