ਗ੍ਰਾਫਾਨਾ ਲਈ ਇੱਕ ਪਲੱਗਇਨ ਦਾ ਵਿਕਾਸ: ਵੱਡੇ ਸ਼ਾਟਸ ਦਾ ਇਤਿਹਾਸ

ਸਾਰਿਆਂ ਨੂੰ ਸਤਿ ਸ਼੍ਰੀ ਅਕਾਲ! ਕੁਝ ਮਹੀਨੇ ਪਹਿਲਾਂ, ਅਸੀਂ ਆਪਣੇ ਨਵੇਂ ਓਪਨ-ਸੋਰਸ ਪ੍ਰੋਜੈਕਟ ਨੂੰ ਉਤਪਾਦਨ ਵਿੱਚ ਲਾਂਚ ਕੀਤਾ - ਕੁਬਰਨੇਟਸ ਦੀ ਨਿਗਰਾਨੀ ਕਰਨ ਲਈ ਗ੍ਰਾਫਾਨਾ ਪਲੱਗਇਨ, ਜਿਸਨੂੰ ਅਸੀਂ ਕਹਿੰਦੇ ਹਾਂ DevOpsProdigy KubeGraf. ਪਲੱਗਇਨ ਸਰੋਤ ਕੋਡ 'ਤੇ ਉਪਲਬਧ ਹੈ GitHub 'ਤੇ ਜਨਤਕ ਭੰਡਾਰ. ਅਤੇ ਇਸ ਲੇਖ ਵਿੱਚ ਅਸੀਂ ਤੁਹਾਡੇ ਨਾਲ ਇਹ ਕਹਾਣੀ ਸਾਂਝੀ ਕਰਨਾ ਚਾਹੁੰਦੇ ਹਾਂ ਕਿ ਅਸੀਂ ਪਲੱਗਇਨ ਕਿਵੇਂ ਬਣਾਇਆ, ਅਸੀਂ ਕਿਹੜੇ ਟੂਲ ਵਰਤੇ ਅਤੇ ਵਿਕਾਸ ਪ੍ਰਕਿਰਿਆ ਦੌਰਾਨ ਸਾਨੂੰ ਕਿਹੜੀਆਂ ਮੁਸ਼ਕਲਾਂ ਦਾ ਸਾਹਮਣਾ ਕਰਨਾ ਪਿਆ। ਚਲਾਂ ਚਲਦੇ ਹਾਂ!

ਭਾਗ 0 - ਸ਼ੁਰੂਆਤੀ: ਅਸੀਂ ਇਸ ਬਿੰਦੂ ਤੱਕ ਕਿਵੇਂ ਪਹੁੰਚੇ?

ਗ੍ਰਾਫਾਨਾ ਲਈ ਆਪਣਾ ਪਲੱਗਇਨ ਲਿਖਣ ਦਾ ਵਿਚਾਰ ਸਾਡੇ ਕੋਲ ਅਚਾਨਕ ਹੀ ਆਇਆ ਸੀ। ਸਾਡੀ ਕੰਪਨੀ 10 ਸਾਲਾਂ ਤੋਂ ਵੱਧ ਸਮੇਂ ਤੋਂ ਵੱਖ-ਵੱਖ ਪੱਧਰਾਂ ਦੀ ਜਟਿਲਤਾ ਦੇ ਵੈਬ ਪ੍ਰੋਜੈਕਟਾਂ ਦੀ ਨਿਗਰਾਨੀ ਕਰ ਰਹੀ ਹੈ। ਇਸ ਸਮੇਂ ਦੌਰਾਨ, ਅਸੀਂ ਵੱਖ-ਵੱਖ ਨਿਗਰਾਨੀ ਪ੍ਰਣਾਲੀਆਂ ਦੀ ਵਰਤੋਂ ਕਰਨ ਵਿੱਚ ਵੱਡੀ ਮਾਤਰਾ ਵਿੱਚ ਮੁਹਾਰਤ, ਦਿਲਚਸਪ ਕੇਸ ਅਤੇ ਤਜਰਬਾ ਇਕੱਠਾ ਕੀਤਾ ਹੈ। ਅਤੇ ਕਿਸੇ ਸਮੇਂ ਅਸੀਂ ਆਪਣੇ ਆਪ ਨੂੰ ਪੁੱਛਿਆ: "ਕੀ ਕੁਬਰਨੇਟਸ ਦੀ ਨਿਗਰਾਨੀ ਕਰਨ ਲਈ ਕੋਈ ਜਾਦੂਈ ਸੰਦ ਹੈ, ਤਾਂ ਜੋ, ਜਿਵੇਂ ਕਿ ਉਹ ਕਹਿੰਦੇ ਹਨ, "ਇਸ ਨੂੰ ਸੈੱਟ ਕਰੋ ਅਤੇ ਇਸਨੂੰ ਭੁੱਲ ਜਾਓ"?".. k8s ਦੀ ਨਿਗਰਾਨੀ ਲਈ ਉਦਯੋਗ ਦਾ ਮਿਆਰ, ਬੇਸ਼ੱਕ, ਲੰਬੇ ਸਮੇਂ ਤੋਂ ਰਿਹਾ ਹੈ Prometheus + Grafana ਸੁਮੇਲ। ਅਤੇ ਇਸ ਸਟੈਕ ਲਈ ਤਿਆਰ ਕੀਤੇ ਹੱਲਾਂ ਦੇ ਰੂਪ ਵਿੱਚ, ਵੱਖ-ਵੱਖ ਕਿਸਮਾਂ ਦੇ ਸਾਧਨਾਂ ਦਾ ਇੱਕ ਵੱਡਾ ਸਮੂਹ ਹੈ: ਪ੍ਰੋਮੀਥੀਅਸ-ਓਪਰੇਟਰ, ਕੁਬਰਨੇਟਸ-ਮਿਕਸਿਨ ਡੈਸ਼ਬੋਰਡਾਂ ਦਾ ਇੱਕ ਸੈੱਟ, ਗ੍ਰਾਫਾਨਾ-ਕੁਬਰਨੇਟਸ-ਐਪ।

grafana-kubernetes-app ਪਲੱਗਇਨ ਸਾਡੇ ਲਈ ਸਭ ਤੋਂ ਦਿਲਚਸਪ ਵਿਕਲਪ ਜਾਪਦਾ ਸੀ, ਪਰ ਇਹ ਇੱਕ ਸਾਲ ਤੋਂ ਵੱਧ ਸਮੇਂ ਲਈ ਸਮਰਥਿਤ ਨਹੀਂ ਹੈ ਅਤੇ ਇਸ ਤੋਂ ਇਲਾਵਾ, ਨੋਡ-ਐਕਸਪੋਰਟਰ ਅਤੇ ਕਿਊਬ-ਸਟੇਟ-ਮੈਟ੍ਰਿਕਸ ਦੇ ਨਵੇਂ ਸੰਸਕਰਣਾਂ ਨਾਲ ਕੰਮ ਨਹੀਂ ਕਰ ਸਕਦਾ ਹੈ। ਅਤੇ ਕਿਸੇ ਸਮੇਂ ਅਸੀਂ ਫੈਸਲਾ ਕੀਤਾ: "ਕੀ ਸਾਨੂੰ ਆਪਣਾ ਫੈਸਲਾ ਨਹੀਂ ਲੈਣਾ ਚਾਹੀਦਾ?"

ਅਸੀਂ ਆਪਣੇ ਪਲੱਗਇਨ ਵਿੱਚ ਕਿਹੜੇ ਵਿਚਾਰ ਲਾਗੂ ਕਰਨ ਦਾ ਫੈਸਲਾ ਕੀਤਾ ਹੈ:

• "ਐਪਲੀਕੇਸ਼ਨ ਮੈਪ" ਦਾ ਵਿਜ਼ੂਅਲਾਈਜ਼ੇਸ਼ਨ: ਕਲੱਸਟਰ ਵਿੱਚ ਐਪਲੀਕੇਸ਼ਨਾਂ ਦੀ ਸੁਵਿਧਾਜਨਕ ਪੇਸ਼ਕਾਰੀ, ਨਾਮ-ਸਥਾਨਾਂ, ਤੈਨਾਤੀਆਂ ਦੁਆਰਾ ਸਮੂਹਬੱਧ ...;
• "ਡਿਪਲਾਇਮੈਂਟ - ਸਰਵਿਸ (+ਪੋਰਟ)" ਵਰਗੇ ਕਨੈਕਸ਼ਨਾਂ ਦੀ ਵਿਜ਼ੂਅਲਾਈਜ਼ੇਸ਼ਨ।
• ਕਲੱਸਟਰ ਨੋਡਾਂ ਵਿੱਚ ਕਲੱਸਟਰ ਐਪਲੀਕੇਸ਼ਨਾਂ ਦੀ ਵੰਡ ਦਾ ਦ੍ਰਿਸ਼ਟੀਕੋਣ।
• ਕਈ ਸਰੋਤਾਂ ਤੋਂ ਮੈਟ੍ਰਿਕਸ ਅਤੇ ਜਾਣਕਾਰੀ ਦਾ ਸੰਗ੍ਰਹਿ: Prometheus ਅਤੇ k8s api ਸਰਵਰ।
• ਬੁਨਿਆਦੀ ਢਾਂਚੇ ਦੇ ਭਾਗਾਂ ਦੀ ਨਿਗਰਾਨੀ (CPU ਸਮਾਂ, ਮੈਮੋਰੀ, ਡਿਸਕ ਸਬ-ਸਿਸਟਮ, ਨੈੱਟਵਰਕ ਦੀ ਵਰਤੋਂ) ਅਤੇ ਐਪਲੀਕੇਸ਼ਨ ਤਰਕ - ਪੌਡਾਂ ਦੀ ਸਿਹਤ-ਸਥਿਤੀ, ਉਪਲਬਧ ਪ੍ਰਤੀਕ੍ਰਿਤੀਆਂ ਦੀ ਸੰਖਿਆ, ਜੀਵਿਤਤਾ/ਤਿਆਰਤਾ ਟੈਸਟ ਪਾਸ ਕਰਨ ਬਾਰੇ ਜਾਣਕਾਰੀ।

ਭਾਗ 1: "Grafana ਪਲੱਗਇਨ" ਕੀ ਹੈ?

ਤਕਨੀਕੀ ਦ੍ਰਿਸ਼ਟੀਕੋਣ ਤੋਂ, Grafana ਲਈ ਪਲੱਗਇਨ ਇੱਕ ਕੋਣ ਕੰਟਰੋਲਰ ਹੈ, ਜੋ ਕਿ Grafana ਡੇਟਾ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਸਟੋਰ ਕੀਤਾ ਜਾਂਦਾ ਹੈ (/var/grafana/plugins//dist/module.js) ਅਤੇ ਇੱਕ SystemJS ਮੋਡੀਊਲ ਵਜੋਂ ਲੋਡ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ। ਨਾਲ ਹੀ ਇਸ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਇੱਕ plugin.json ਫਾਈਲ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ ਜਿਸ ਵਿੱਚ ਤੁਹਾਡੇ ਪਲੱਗਇਨ ਬਾਰੇ ਸਾਰੀ ਮੈਟਾ ਜਾਣਕਾਰੀ ਸ਼ਾਮਲ ਹੋਵੇ: ਨਾਮ, ਸੰਸਕਰਣ, ਪਲੱਗਇਨ ਕਿਸਮ, ਰਿਪੋਜ਼ਟਰੀ/ਸਾਈਟ/ਲਾਇਸੈਂਸ, ਨਿਰਭਰਤਾਵਾਂ, ਆਦਿ ਦੇ ਲਿੰਕ।

module.ts

plugin.json

ਜਿਵੇਂ ਕਿ ਤੁਸੀਂ ਸਕ੍ਰੀਨਸ਼ੌਟ ਵਿੱਚ ਦੇਖ ਸਕਦੇ ਹੋ, ਅਸੀਂ plugin.type = ਐਪ ਨੂੰ ਨਿਸ਼ਚਿਤ ਕੀਤਾ ਹੈ। ਕਿਉਂਕਿ Grafana ਲਈ ਪਲੱਗਇਨ ਤਿੰਨ ਕਿਸਮਾਂ ਦੇ ਹੋ ਸਕਦੇ ਹਨ:

ਪੈਨਲ ਨੂੰ: ਪਲੱਗਇਨ ਦੀ ਸਭ ਤੋਂ ਆਮ ਕਿਸਮ - ਇਹ ਕਿਸੇ ਵੀ ਮੈਟ੍ਰਿਕਸ ਦੀ ਕਲਪਨਾ ਕਰਨ ਲਈ ਇੱਕ ਪੈਨਲ ਹੈ, ਜੋ ਵੱਖ-ਵੱਖ ਡੈਸ਼ਬੋਰਡ ਬਣਾਉਣ ਲਈ ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ।
ਡਾਟਾ ਸਰੋਤ: ਪਲੱਗਇਨ ਕੁਨੈਕਟਰ ਕੁਝ ਡਾਟਾ ਸਰੋਤ (ਉਦਾਹਰਨ ਲਈ, Prometheus-datasource, ClickHouse-datasource, ElasticSearch-datasource)।
ਐਪ: ਇੱਕ ਪਲੱਗਇਨ ਜੋ ਤੁਹਾਨੂੰ Grafana ਦੇ ਅੰਦਰ ਆਪਣੀ ਖੁਦ ਦੀ ਫਰੰਟਐਂਡ ਐਪਲੀਕੇਸ਼ਨ ਬਣਾਉਣ, ਆਪਣੇ ਖੁਦ ਦੇ html ਪੰਨੇ ਬਣਾਉਣ ਅਤੇ ਵੱਖ-ਵੱਖ ਡੇਟਾ ਦੀ ਕਲਪਨਾ ਕਰਨ ਲਈ ਡੈਟਾਸੋਰਸ ਨੂੰ ਹੱਥੀਂ ਐਕਸੈਸ ਕਰਨ ਦੀ ਆਗਿਆ ਦਿੰਦੀ ਹੈ। ਨਾਲ ਹੀ, ਹੋਰ ਕਿਸਮਾਂ ਦੇ ਪਲੱਗਇਨ (ਡੇਟਾ ਸਰੋਤ, ਪੈਨਲ) ਅਤੇ ਵੱਖ-ਵੱਖ ਡੈਸ਼ਬੋਰਡਾਂ ਨੂੰ ਨਿਰਭਰਤਾ ਵਜੋਂ ਵਰਤਿਆ ਜਾ ਸਕਦਾ ਹੈ।

ਟਾਈਪ=ਐਪ ਦੇ ਨਾਲ ਪਲੱਗਇਨ ਨਿਰਭਰਤਾ ਦੀ ਉਦਾਹਰਨ.

ਤੁਸੀਂ ਇੱਕ ਪ੍ਰੋਗਰਾਮਿੰਗ ਭਾਸ਼ਾ ਵਜੋਂ JavaScript ਅਤੇ TypeScript ਦੋਵਾਂ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ (ਅਸੀਂ ਇਸਨੂੰ ਚੁਣਿਆ ਹੈ)। ਕਿਸੇ ਵੀ ਕਿਸਮ ਦੇ ਹੈਲੋ-ਵਰਲਡ ਪਲੱਗਇਨ ਲਈ ਤਿਆਰੀਆਂ ਜੋ ਤੁਸੀਂ ਕਰ ਸਕਦੇ ਹੋ ਲਿੰਕ ਲੱਭੋ: ਇਸ ਰਿਪੋਜ਼ਟਰੀ ਵਿੱਚ ਪੂਰਵ-ਸਥਾਪਤ ਅਤੇ ਸੰਰਚਿਤ ਬਿਲਡਰਾਂ ਦੇ ਨਾਲ ਵੱਡੀ ਗਿਣਤੀ ਵਿੱਚ ਸਟਾਰਟਰ-ਪੈਕ (ਰਿਐਕਟ ਵਿੱਚ ਇੱਕ ਪਲੱਗਇਨ ਦੀ ਇੱਕ ਪ੍ਰਯੋਗਾਤਮਕ ਉਦਾਹਰਣ ਵੀ ਹੈ) ਸ਼ਾਮਲ ਹਨ।

ਭਾਗ 2: ਸਥਾਨਕ ਵਾਤਾਵਰਣ ਨੂੰ ਤਿਆਰ ਕਰਨਾ

ਪਲੱਗਇਨ 'ਤੇ ਕੰਮ ਕਰਨ ਲਈ, ਸਾਨੂੰ ਕੁਦਰਤੀ ਤੌਰ 'ਤੇ ਸਾਰੇ ਪੂਰਵ-ਇੰਸਟਾਲ ਕੀਤੇ ਟੂਲਸ ਦੇ ਨਾਲ ਇੱਕ kubernetes ਕਲੱਸਟਰ ਦੀ ਲੋੜ ਹੈ: prometheus, node-exporter, kube-state-metrics, grafana. ਵਾਤਾਵਰਣ ਨੂੰ ਤੇਜ਼ੀ ਨਾਲ, ਆਸਾਨੀ ਨਾਲ ਅਤੇ ਕੁਦਰਤੀ ਤੌਰ 'ਤੇ ਸਥਾਪਤ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ, ਅਤੇ ਹੌਟ-ਰੀਲੋਡ ਨੂੰ ਯਕੀਨੀ ਬਣਾਉਣ ਲਈ, ਗ੍ਰਾਫਾਨਾ ਡੇਟਾ ਡਾਇਰੈਕਟਰੀ ਨੂੰ ਡਿਵੈਲਪਰ ਦੀ ਮਸ਼ੀਨ ਤੋਂ ਸਿੱਧਾ ਮਾਊਂਟ ਕੀਤਾ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ।

ਸਾਡੀ ਰਾਏ ਵਿੱਚ, ਕੁਬਰਨੇਟਸ ਨਾਲ ਸਥਾਨਕ ਤੌਰ 'ਤੇ ਕੰਮ ਕਰਨ ਦਾ ਸਭ ਤੋਂ ਸੁਵਿਧਾਜਨਕ ਤਰੀਕਾ ਹੈ minikube. ਅਗਲਾ ਕਦਮ ਪ੍ਰੋਮੀਥੀਅਸ-ਓਪਰੇਟਰ ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਪ੍ਰੋਮੀਥੀਅਸ + ਗ੍ਰਾਫਾਨਾ ਸੁਮੇਲ ਨੂੰ ਸਥਾਪਤ ਕਰਨਾ ਹੈ। IN ਇਹ ਲੇਖ ਮਿਨੀਕਿਊਬ 'ਤੇ ਪ੍ਰੋਮੀਥੀਅਸ-ਓਪਰੇਟਰ ਨੂੰ ਸਥਾਪਿਤ ਕਰਨ ਦੀ ਪ੍ਰਕਿਰਿਆ ਦਾ ਵਿਸਥਾਰ ਵਿੱਚ ਵਰਣਨ ਕੀਤਾ ਗਿਆ ਹੈ। ਸਥਿਰਤਾ ਨੂੰ ਸਮਰੱਥ ਕਰਨ ਲਈ, ਤੁਹਾਨੂੰ ਪੈਰਾਮੀਟਰ ਸੈੱਟ ਕਰਨਾ ਚਾਹੀਦਾ ਹੈ ਸਥਿਰਤਾ: ਸੱਚ ਹੈ charts/grafana/values.yaml ਫਾਈਲ ਵਿੱਚ, ਆਪਣੀ ਖੁਦ ਦੀ PV ਅਤੇ PVC ਸ਼ਾਮਲ ਕਰੋ ਅਤੇ ਉਹਨਾਂ ਨੂੰ persistence.existingClaim ਪੈਰਾਮੀਟਰ ਵਿੱਚ ਦਿਓ

ਸਾਡੀ ਅੰਤਿਮ ਮਿਨੀਕਿਊਬ ਲਾਂਚ ਸਕ੍ਰਿਪਟ ਇਸ ਤਰ੍ਹਾਂ ਦਿਖਾਈ ਦਿੰਦੀ ਹੈ:

minikube start --kubernetes-version=v1.13.4 --memory=4096 --bootstrapper=kubeadm --extra-config=scheduler.address=0.0.0.0 --extra-config=controller-manager.address=0.0.0.0
minikube mount 
/home/sergeisporyshev/Projects/Grafana:/var/grafana --gid=472 --uid=472 --9p-version=9p2000.L

ਭਾਗ 3: ਅਸਲ ਵਿਕਾਸ

ਵਸਤੂ ਮਾਡਲ

ਪਲੱਗਇਨ ਨੂੰ ਲਾਗੂ ਕਰਨ ਦੀ ਤਿਆਰੀ ਵਿੱਚ, ਅਸੀਂ ਉਹਨਾਂ ਸਾਰੀਆਂ ਬੁਨਿਆਦੀ Kubernetes ਇਕਾਈਆਂ ਦਾ ਵਰਣਨ ਕਰਨ ਦਾ ਫੈਸਲਾ ਕੀਤਾ ਹੈ ਜਿਹਨਾਂ ਨਾਲ ਅਸੀਂ TypeScript ਕਲਾਸਾਂ ਦੇ ਰੂਪ ਵਿੱਚ ਕੰਮ ਕਰਾਂਗੇ: ਪੌਡ, ਡਿਪਲਾਇਮੈਂਟ, ਡੈਮਨਸੈੱਟ, ਸਟੇਟਫੁੱਲਸੈੱਟ, ਨੌਕਰੀ, ਕ੍ਰੋਨਜੌਬ, ਸੇਵਾ, ਨੋਡ, ਨੇਮਸਪੇਸ। ਇਹਨਾਂ ਵਿੱਚੋਂ ਹਰ ਇੱਕ ਕਲਾਸ ਆਮ ਬੇਸ ਮਾਡਲ ਕਲਾਸ ਤੋਂ ਵਿਰਾਸਤ ਵਿੱਚ ਮਿਲਦੀ ਹੈ, ਜੋ ਕਿ ਕੰਸਟਰਕਟਰ, ਡਿਸਟ੍ਰਕਟਰ, ਦਿੱਖ ਨੂੰ ਅੱਪਡੇਟ ਕਰਨ ਅਤੇ ਬਦਲਣ ਦੇ ਢੰਗਾਂ ਦਾ ਵਰਣਨ ਕਰਦੀ ਹੈ। ਹਰੇਕ ਕਲਾਸ ਦੂਜੀਆਂ ਇਕਾਈਆਂ ਨਾਲ ਨੇਸਟਡ ਸਬੰਧਾਂ ਦਾ ਵਰਣਨ ਕਰਦੀ ਹੈ, ਉਦਾਹਰਨ ਲਈ, ਕਿਸਮ ਦੀ ਤੈਨਾਤੀ ਦੀ ਇਕਾਈ ਲਈ ਪੌਡਾਂ ਦੀ ਸੂਚੀ।

import {Pod} from "./pod";
import {Service} from "./service";
import {BaseModel} from './traits/baseModel';

export class Deployment extends BaseModel{
   pods: Array<Pod>;
   services: Array<Service>;

   constructor(data: any){
       super(data);
       this.pods = [];
       this.services = [];
   }
}

ਗੈਟਰਾਂ ਅਤੇ ਸੇਟਰਾਂ ਦੀ ਮਦਦ ਨਾਲ, ਅਸੀਂ ਇੱਕ ਸੁਵਿਧਾਜਨਕ ਅਤੇ ਪੜ੍ਹਨਯੋਗ ਰੂਪ ਵਿੱਚ ਲੋੜੀਂਦੇ ਇਕਾਈ ਮੈਟ੍ਰਿਕਸ ਨੂੰ ਪ੍ਰਦਰਸ਼ਿਤ ਜਾਂ ਸੈੱਟ ਕਰ ਸਕਦੇ ਹਾਂ। ਉਦਾਹਰਨ ਲਈ, ਅਲਾਕੇਟੇਬਲ cpu ਨੋਡਸ ਦੀ ਫਾਰਮੈਟ ਕੀਤੀ ਆਉਟਪੁੱਟ:

get cpuAllocatableFormatted(){
   let cpu = this.data.status.allocatable.cpu;
   if(cpu.indexOf('m') > -1){
       cpu = parseInt(cpu)/1000;
   }
   return cpu;
}

ਪੰਨੇ

ਸਾਡੇ ਸਾਰੇ ਪਲੱਗਇਨ ਪੰਨਿਆਂ ਦੀ ਸੂਚੀ ਸ਼ੁਰੂ ਵਿੱਚ ਸਾਡੇ pluing.json ਵਿੱਚ ਨਿਰਭਰਤਾ ਭਾਗ ਵਿੱਚ ਵਰਣਨ ਕੀਤੀ ਗਈ ਹੈ:

ਹਰੇਕ ਪੰਨੇ ਲਈ ਬਲਾਕ ਵਿੱਚ ਸਾਨੂੰ ਪੰਨਾ ਨਾਮ ਦਰਸਾਉਣਾ ਚਾਹੀਦਾ ਹੈ (ਇਸ ਨੂੰ ਫਿਰ ਇੱਕ ਸਲੱਗ ਵਿੱਚ ਬਦਲ ਦਿੱਤਾ ਜਾਵੇਗਾ ਜਿਸ ਦੁਆਰਾ ਇਹ ਪੰਨਾ ਪਹੁੰਚਯੋਗ ਹੋਵੇਗਾ); ਇਸ ਪੰਨੇ ਦੇ ਸੰਚਾਲਨ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਹਿੱਸੇ ਦਾ ਨਾਮ (ਕੰਪੋਨੈਂਟਾਂ ਦੀ ਸੂਚੀ module.ts ਨੂੰ ਨਿਰਯਾਤ ਕੀਤੀ ਜਾਂਦੀ ਹੈ); ਉਪਭੋਗਤਾ ਦੀ ਭੂਮਿਕਾ ਨੂੰ ਦਰਸਾਉਂਦਾ ਹੈ ਜਿਸ ਲਈ ਇਸ ਪੰਨੇ ਨਾਲ ਕੰਮ ਉਪਲਬਧ ਹੈ ਅਤੇ ਸਾਈਡਬਾਰ ਲਈ ਨੈਵੀਗੇਸ਼ਨ ਸੈਟਿੰਗਾਂ।

ਪੰਨੇ ਦੇ ਸੰਚਾਲਨ ਲਈ ਜ਼ਿੰਮੇਵਾਰ ਹਿੱਸੇ ਵਿੱਚ, ਸਾਨੂੰ ਟੈਂਪਲੇਟਯੂਆਰਐਲ ਸੈੱਟ ਕਰਨਾ ਚਾਹੀਦਾ ਹੈ, ਉੱਥੇ ਮਾਰਕਅੱਪ ਦੇ ਨਾਲ html ਫਾਈਲ ਦਾ ਮਾਰਗ ਪਾਸ ਕਰਨਾ ਚਾਹੀਦਾ ਹੈ। ਕੰਟਰੋਲਰ ਦੇ ਅੰਦਰ, ਨਿਰਭਰਤਾ ਟੀਕੇ ਦੁਆਰਾ, ਅਸੀਂ 2 ਮਹੱਤਵਪੂਰਨ ਕੋਣ ਸੇਵਾਵਾਂ ਤੱਕ ਪਹੁੰਚ ਕਰ ਸਕਦੇ ਹਾਂ:

• backendSrv - ਇੱਕ ਸੇਵਾ ਜੋ Grafana API ਸਰਵਰ ਨਾਲ ਪਰਸਪਰ ਪ੍ਰਭਾਵ ਪ੍ਰਦਾਨ ਕਰਦੀ ਹੈ;
• datasourceSrv ਇੱਕ ਸੇਵਾ ਹੈ ਜੋ ਤੁਹਾਡੇ Grafana ਵਿੱਚ ਸਥਾਪਿਤ ਸਾਰੇ ਡਾਟਾ ਸਰੋਤਾਂ ਨਾਲ ਸਥਾਨਕ ਪਰਸਪਰ ਪ੍ਰਭਾਵ ਪ੍ਰਦਾਨ ਕਰਦੀ ਹੈ (ਉਦਾਹਰਨ ਲਈ, .getAll() ਵਿਧੀ - ਸਾਰੇ ਇੰਸਟੌਲ ਕੀਤੇ ਡੇਟਾ ਸਰੋਤਾਂ ਦੀ ਸੂਚੀ ਵਾਪਸ ਕਰਦੀ ਹੈ; .get() - ਇੱਕ ਖਾਸ ਡੇਟਾ ਸਰੋਤ ਦੀ ਇੱਕ ਉਦਾਹਰਨ ਵਸਤੂ ਵਾਪਸ ਕਰਦੀ ਹੈ। .

ਭਾਗ 4: ਡਾਟਾ ਸਰੋਤ

Grafana ਦੇ ਦ੍ਰਿਸ਼ਟੀਕੋਣ ਤੋਂ, ਡੇਟਾਸੋਰਸ ਬਿਲਕੁਲ ਉਹੀ ਪਲੱਗਇਨ ਹੈ ਜੋ ਬਾਕੀ ਸਾਰੇ ਹਨ: ਇਸਦਾ ਆਪਣਾ ਐਂਟਰੀ ਪੁਆਇੰਟ module.js ਹੈ, ਮੈਟਾ ਜਾਣਕਾਰੀ plugin.json ਵਾਲੀ ਇੱਕ ਫਾਈਲ ਹੈ। ਟਾਈਪ = ਐਪ ਦੇ ਨਾਲ ਇੱਕ ਪਲੱਗਇਨ ਵਿਕਸਿਤ ਕਰਦੇ ਸਮੇਂ, ਅਸੀਂ ਮੌਜੂਦਾ ਡੇਟਾਸੋਰਸ (ਉਦਾਹਰਨ ਲਈ, ਪ੍ਰੋਮੀਥੀਅਸ-ਡੇਟਾਸੋਰਸ) ਅਤੇ ਆਪਣੇ ਖੁਦ ਦੇ ਦੋਵਾਂ ਨਾਲ ਇੰਟਰੈਕਟ ਕਰ ਸਕਦੇ ਹਾਂ, ਜਿਸ ਨੂੰ ਅਸੀਂ ਸਿੱਧਾ ਪਲੱਗਇਨ ਡਾਇਰੈਕਟਰੀ (dist/datasource/*) ਵਿੱਚ ਸਟੋਰ ਕਰ ਸਕਦੇ ਹਾਂ ਜਾਂ ਇੱਕ ਨਿਰਭਰਤਾ ਵਜੋਂ ਸਥਾਪਤ ਕਰ ਸਕਦੇ ਹਾਂ। ਸਾਡੇ ਕੇਸ ਵਿੱਚ, ਡੇਟਾਸੋਰਸ ਪਲੱਗਇਨ ਕੋਡ ਦੇ ਨਾਲ ਆਉਂਦਾ ਹੈ। ਇੱਕ config.html ਟੈਮਪਲੇਟ ਅਤੇ ਇੱਕ ConfigCtrl ਕੰਟਰੋਲਰ ਹੋਣਾ ਵੀ ਜ਼ਰੂਰੀ ਹੈ, ਜੋ ਕਿ ਡੇਟਾਸੋਰਸ ਇੰਸਟੈਂਸ ਕੌਂਫਿਗਰੇਸ਼ਨ ਪੰਨੇ ਅਤੇ ਡੇਟਾਸੋਰਸ ਕੰਟਰੋਲਰ ਲਈ ਵਰਤਿਆ ਜਾਵੇਗਾ, ਜੋ ਤੁਹਾਡੇ ਡੇਟਾਸੋਰਸ ਦੇ ਓਪਰੇਟਿੰਗ ਤਰਕ ਨੂੰ ਲਾਗੂ ਕਰਦਾ ਹੈ।

KubeGraf ਪਲੱਗਇਨ ਵਿੱਚ, ਉਪਭੋਗਤਾ ਇੰਟਰਫੇਸ ਦ੍ਰਿਸ਼ਟੀਕੋਣ ਤੋਂ, ਡੇਟਾਸੋਰਸ ਇੱਕ kubernetes ਕਲੱਸਟਰ ਦੀ ਇੱਕ ਉਦਾਹਰਣ ਹੈ ਜੋ ਹੇਠਾਂ ਦਿੱਤੀਆਂ ਯੋਗਤਾਵਾਂ ਨੂੰ ਲਾਗੂ ਕਰਦਾ ਹੈ (ਸਰੋਤ ਕੋਡ ਉਪਲਬਧ ਹੈ ਲਿੰਕ):

• k8s ਏਪੀਆਈ-ਸਰਵਰ ਤੋਂ ਡਾਟਾ ਇਕੱਠਾ ਕਰਨਾ (ਨੇਮ ਸਪੇਸ, ਤੈਨਾਤੀਆਂ ਦੀ ਸੂਚੀ ਪ੍ਰਾਪਤ ਕਰਨਾ...)
• ਪ੍ਰੋਮੀਥੀਅਸ-ਡੇਟਾਸੋਰਸ (ਜੋ ਹਰੇਕ ਖਾਸ ਕਲੱਸਟਰ ਲਈ ਪਲੱਗਇਨ ਸੈਟਿੰਗਾਂ ਵਿੱਚ ਚੁਣਿਆ ਗਿਆ ਹੈ) ਲਈ ਬੇਨਤੀਆਂ ਨੂੰ ਪ੍ਰੌਕਸੀ ਕਰਨਾ ਅਤੇ ਸਥਿਰ ਪੰਨਿਆਂ ਅਤੇ ਡੈਸ਼ਬੋਰਡਾਂ ਵਿੱਚ ਡੇਟਾ ਦੀ ਵਰਤੋਂ ਕਰਨ ਲਈ ਜਵਾਬਾਂ ਨੂੰ ਫਾਰਮੈਟ ਕਰਨਾ।
• ਸਥਿਰ ਪਲੱਗਇਨ ਪੰਨਿਆਂ 'ਤੇ ਡਾਟਾ ਅੱਪਡੇਟ ਕਰਨਾ (ਇੱਕ ਸੈੱਟ ਰਿਫਰੈਸ਼ ਦਰ ਨਾਲ)।
• ਗ੍ਰਾਫਾਨਾ-ਡੈਸ਼ਬੋਰਡਸ (metriFindQuery() ਵਿਧੀ) ਵਿੱਚ ਇੱਕ ਟੈਂਪਲੇਟ ਸ਼ੀਟ ਬਣਾਉਣ ਲਈ ਪੁੱਛਗਿੱਛਾਂ ਦੀ ਪ੍ਰਕਿਰਿਆ ਕਰਨਾ

• ਫਾਈਨਲ k8s ਕਲੱਸਟਰ ਨਾਲ ਕੁਨੈਕਸ਼ਨ ਟੈਸਟ।

testDatasource(){
   let url = '/api/v1/namespaces';
   let _url = this.url;
   if(this.accessViaToken)
       _url += '/__proxy';
   _url += url;
   return this.backendSrv.datasourceRequest({
       url: _url,
       method: "GET",
       headers: {"Content-Type": 'application/json'}
   })
       .then(response => {
           if (response.status === 200) {
               return {status: "success", message: "Data source is OK", title: "Success"};
           }else{
               return {status: "error", message: "Data source is not OK", title: "Error"};
           }
       }, error => {
           return {status: "error", message: "Data source is not OK", title: "Error"};
       })
}

ਇੱਕ ਵੱਖਰਾ ਦਿਲਚਸਪ ਬਿੰਦੂ, ਸਾਡੀ ਰਾਏ ਵਿੱਚ, ਡੇਟਾ ਸਰੋਤ ਲਈ ਪ੍ਰਮਾਣਿਕਤਾ ਅਤੇ ਪ੍ਰਮਾਣਿਕਤਾ ਵਿਧੀ ਨੂੰ ਲਾਗੂ ਕਰਨਾ ਹੈ। ਆਮ ਤੌਰ 'ਤੇ, ਬਾਕਸ ਤੋਂ ਬਾਹਰ, ਅਸੀਂ ਅੰਤਮ ਡੇਟਾ ਸਰੋਤ ਤੱਕ ਪਹੁੰਚ ਨੂੰ ਕੌਂਫਿਗਰ ਕਰਨ ਲਈ ਬਿਲਟ-ਇਨ ਗ੍ਰਾਫਾਨਾ ਕੰਪੋਨੈਂਟ ਡੇਟਾਸੋਰਸHttpSettings ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹਾਂ। ਇਸ ਕੰਪੋਨੈਂਟ ਦੀ ਵਰਤੋਂ ਕਰਦੇ ਹੋਏ, ਅਸੀਂ url ਅਤੇ ਮੂਲ ਪ੍ਰਮਾਣੀਕਰਨ/ਪ੍ਰਮਾਣੀਕਰਨ ਸੈਟਿੰਗਾਂ: ਲੌਗਇਨ-ਪਾਸਵਰਡ, ਜਾਂ ਕਲਾਇੰਟ-ਸਰਟ/ਕਲਾਇੰਟ-ਕੁੰਜੀ ਨੂੰ ਨਿਸ਼ਚਿਤ ਕਰਕੇ http ਡਾਟਾ ਸਰੋਤ ਤੱਕ ਪਹੁੰਚ ਨੂੰ ਕੌਂਫਿਗਰ ਕਰ ਸਕਦੇ ਹਾਂ। ਇੱਕ ਬੇਅਰਰ ਟੋਕਨ (k8s ਲਈ ਡੀ ਫੈਕਟੋ ਸਟੈਂਡਰਡ) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਪਹੁੰਚ ਨੂੰ ਕੌਂਫਿਗਰ ਕਰਨ ਦੀ ਯੋਗਤਾ ਨੂੰ ਲਾਗੂ ਕਰਨ ਲਈ, ਸਾਨੂੰ ਥੋੜਾ ਜਿਹਾ ਟਵੀਕਿੰਗ ਕਰਨਾ ਪਿਆ।

ਇਸ ਸਮੱਸਿਆ ਨੂੰ ਹੱਲ ਕਰਨ ਲਈ, ਤੁਸੀਂ ਬਿਲਟ-ਇਨ ਗ੍ਰਾਫਾਨਾ "ਪਲੱਗਇਨ ਰੂਟਸ" ਵਿਧੀ ਦੀ ਵਰਤੋਂ ਕਰ ਸਕਦੇ ਹੋ (ਵਧੇਰੇ ਵੇਰਵੇ ਇੱਥੇ ਅਧਿਕਾਰਤ ਦਸਤਾਵੇਜ਼ ਪੰਨਾ). ਸਾਡੇ ਡੇਟਾਸੋਰਸ ਦੀਆਂ ਸੈਟਿੰਗਾਂ ਵਿੱਚ, ਅਸੀਂ ਰੂਟਿੰਗ ਨਿਯਮਾਂ ਦੇ ਇੱਕ ਸਮੂਹ ਦੀ ਘੋਸ਼ਣਾ ਕਰ ਸਕਦੇ ਹਾਂ ਜੋ ਗ੍ਰਾਫਾਨਾ ਪ੍ਰੌਕਸੀ ਸਰਵਰ ਦੁਆਰਾ ਪ੍ਰਕਿਰਿਆ ਕੀਤੀ ਜਾਵੇਗੀ। ਉਦਾਹਰਨ ਲਈ, ਹਰੇਕ ਵਿਅਕਤੀਗਤ ਅੰਤਮ ਬਿੰਦੂ ਲਈ ਟੈਂਪਲੇਟਿੰਗ ਦੀ ਸੰਭਾਵਨਾ ਦੇ ਨਾਲ ਸਿਰਲੇਖ ਜਾਂ url ਸੈਟ ਕਰਨ ਦੀ ਸੰਭਾਵਨਾ ਹੁੰਦੀ ਹੈ, ਜਿਸ ਲਈ ਡੇਟਾ jsonData ਅਤੇ safeJsonData ਖੇਤਰਾਂ ਤੋਂ ਲਿਆ ਜਾ ਸਕਦਾ ਹੈ (ਇਨਕ੍ਰਿਪਟਡ ਰੂਪ ਵਿੱਚ ਪਾਸਵਰਡ ਜਾਂ ਟੋਕਨਾਂ ਨੂੰ ਸਟੋਰ ਕਰਨ ਲਈ)। ਸਾਡੇ ਉਦਾਹਰਨ ਵਿੱਚ, ਪ੍ਰਸ਼ਨ ਜਿਵੇਂ ਕਿ /__proxy/api/v1/namespaces ਫਾਰਮ ਦੇ url ਨਾਲ ਪ੍ਰੌਕਸੀ ਕੀਤਾ ਜਾਵੇਗਾ
ਅਧਿਕਾਰ ਦੇ ਨਾਲ /api/v8/ਨਾਮ ਸਪੇਸ: ਬੇਅਰਰ ਹੈਡਰ।

ਕੁਦਰਤੀ ਤੌਰ 'ਤੇ, k8s api ਸਰਵਰ ਨਾਲ ਕੰਮ ਕਰਨ ਲਈ ਸਾਨੂੰ ਸਿਰਫ਼ ਪੜ੍ਹਨ ਲਈ ਪਹੁੰਚ ਵਾਲੇ ਉਪਭੋਗਤਾ ਦੀ ਲੋੜ ਹੈ, ਜਿਸ ਨੂੰ ਬਣਾਉਣ ਲਈ ਤੁਸੀਂ ਇਸ ਵਿੱਚ ਵੀ ਲੱਭ ਸਕਦੇ ਹੋ। ਪਲੱਗਇਨ ਸਰੋਤ ਕੋਡ.

ਭਾਗ 5: ਰਿਲੀਜ਼

ਇੱਕ ਵਾਰ ਜਦੋਂ ਤੁਸੀਂ ਆਪਣਾ Grafana ਪਲੱਗਇਨ ਲਿਖ ਲੈਂਦੇ ਹੋ, ਤਾਂ ਤੁਸੀਂ ਕੁਦਰਤੀ ਤੌਰ 'ਤੇ ਇਸਨੂੰ ਜਨਤਕ ਤੌਰ 'ਤੇ ਉਪਲਬਧ ਕਰਵਾਉਣਾ ਚਾਹੋਗੇ। Grafana ਵਿੱਚ ਇਹ ਇੱਥੇ ਉਪਲਬਧ ਪਲੱਗਇਨਾਂ ਦੀ ਇੱਕ ਲਾਇਬ੍ਰੇਰੀ ਹੈ grafana.com/grafana/plugins

ਤੁਹਾਡੇ ਪਲੱਗਇਨ ਦੇ ਅਧਿਕਾਰਤ ਸਟੋਰ 'ਤੇ ਉਪਲਬਧ ਹੋਣ ਲਈ, ਤੁਹਾਨੂੰ ਇੱਕ PR ਬਣਾਉਣ ਦੀ ਲੋੜ ਹੈ ਇਹ ਰਿਪੋਜ਼ਟਰੀrepo.json ਫਾਈਲ ਵਿੱਚ ਇਸ ਤਰ੍ਹਾਂ ਦੀ ਸਮੱਗਰੀ ਜੋੜ ਕੇ:

ਜਿੱਥੇ ਸੰਸਕਰਣ ਤੁਹਾਡੇ ਪਲੱਗਇਨ ਦਾ ਸੰਸਕਰਣ ਹੈ, url ਰਿਪੋਜ਼ਟਰੀ ਦਾ ਇੱਕ ਲਿੰਕ ਹੈ, ਅਤੇ ਕਮਿਟ ਕਮਿਟ ਦਾ ਹੈਸ਼ ਹੈ ਜਿਸ ਲਈ ਪਲੱਗਇਨ ਦਾ ਇੱਕ ਖਾਸ ਸੰਸਕਰਣ ਉਪਲਬਧ ਹੋਵੇਗਾ।

ਅਤੇ ਆਉਟਪੁੱਟ 'ਤੇ ਤੁਸੀਂ ਇੱਕ ਸ਼ਾਨਦਾਰ ਤਸਵੀਰ ਦੇਖੋਗੇ ਜਿਵੇਂ ਕਿ:

ਇਸਦੇ ਲਈ ਡੇਟਾ ਤੁਹਾਡੇ Readme.md, Changelog.md ਅਤੇ ਪਲੱਗਇਨ ਵੇਰਵੇ ਵਾਲੀ plugin.json ਫਾਈਲ ਤੋਂ ਆਪਣੇ ਆਪ ਹੀ ਪ੍ਰਾਪਤ ਕੀਤਾ ਜਾਵੇਗਾ।

ਭਾਗ 6: ਸਿੱਟੇ ਦੀ ਬਜਾਏ

ਅਸੀਂ ਰੀਲੀਜ਼ ਤੋਂ ਬਾਅਦ ਸਾਡੇ ਪਲੱਗਇਨ ਨੂੰ ਵਿਕਸਤ ਕਰਨਾ ਬੰਦ ਨਹੀਂ ਕੀਤਾ. ਅਤੇ ਹੁਣ ਅਸੀਂ ਕਲੱਸਟਰ ਨੋਡਾਂ ਦੇ ਸਰੋਤਾਂ ਦੀ ਵਰਤੋਂ ਦੀ ਸਹੀ ਢੰਗ ਨਾਲ ਨਿਗਰਾਨੀ ਕਰਨ, UX ਨੂੰ ਬਿਹਤਰ ਬਣਾਉਣ ਲਈ ਨਵੀਆਂ ਵਿਸ਼ੇਸ਼ਤਾਵਾਂ ਪੇਸ਼ ਕਰਨ, ਅਤੇ ਸਾਡੇ ਗ੍ਰਾਹਕਾਂ ਦੁਆਰਾ ਅਤੇ GitHub (ਜੇ ਤੁਸੀਂ ਛੱਡਦੇ ਹੋ) ਦੋਵਾਂ ਦੁਆਰਾ ਪਲੱਗਇਨ ਨੂੰ ਸਥਾਪਿਤ ਕਰਨ ਤੋਂ ਬਾਅਦ ਪ੍ਰਾਪਤ ਹੋਏ ਫੀਡਬੈਕ ਦੀ ਇੱਕ ਵੱਡੀ ਮਾਤਰਾ ਵਿੱਚ ਪ੍ਰਾਪਤ ਕਰਨ 'ਤੇ ਕੰਮ ਕਰ ਰਹੇ ਹਾਂ। ਤੁਹਾਡਾ ਮੁੱਦਾ ਜਾਂ ਪੁੱਲ ਬੇਨਤੀ, ਮੈਂ ਬਹੁਤ ਖੁਸ਼ ਹੋਵਾਂਗਾ :)

ਅਸੀਂ ਉਮੀਦ ਕਰਦੇ ਹਾਂ ਕਿ ਇਹ ਲੇਖ ਤੁਹਾਨੂੰ ਗ੍ਰਾਫਾਨਾ ਵਰਗੇ ਸ਼ਾਨਦਾਰ ਟੂਲ ਨੂੰ ਸਮਝਣ ਵਿੱਚ ਮਦਦ ਕਰੇਗਾ ਅਤੇ, ਸ਼ਾਇਦ, ਆਪਣੀ ਖੁਦ ਦੀ ਪਲੱਗਇਨ ਲਿਖੋ.

ਤੁਹਾਡਾ ਧੰਨਵਾਦ!)

ਸਰੋਤ: www.habr.com