Zbbix API को C # में समझना

ज़ैबिक्स में मॉनिटरिंग सर्वर फ़ंक्शंस को एक्सेस करने के लिए एक ओपन एपीआई है। दुर्भाग्य से, एपीआई तक पहुंचने के लिए पुस्तकालय का एक कार्यान्वयन केवल रूबी, पीएचपी और पायथन के लिए मौजूद है। मुझे अपने दम पर पहिया को फिर से मजबूत करना था। सभी कार्यों तक पहुंच JSONRPC के माध्यम से जाती है । एक उदाहरण के अनुरोध के लिए, Zabbix API वर्जन की प्रतिक्रिया से फ़ंक्शन कुछ इस तरह दिखता है:

{ "jsonrpc" : "2.0" , "method" : "apiinfo.version" , "params" :[], "auth" : "a6e895b98fde40f4f7badf112fd983bf" , "id" :2 } <br>{ "jsonrpc" : "2.0" , "result" : "1.3" , "id" :2 } * This source code was highlighted with Source Code Highlighter .







JSON-RPC प्रोटोकॉल का विस्तृत विवरण लेख के लक्ष्य में शामिल नहीं है, हम कार्यान्वयन के साथ आगे बढ़ेंगे:

  1. private string GetWebRequest( string body)



  2. {



  3. WebRequest wb = WebRequest.Create(url);



  4. wb.ContentType = @"application/json-rpc" ;



  5. wb.Credentials = CredentialCache.DefaultCredentials;



  6. ASCIIEncoding encoding = new ASCIIEncoding();



  7. string postData = body;



  8. byte [] data = encoding.GetBytes(postData);



  9. wb.Method = "POST" ;



  10. wb.ContentLength = data.Length;



  11. Stream newStream = wb.GetRequestStream();



  12. newStream.Write(data, 0, data.Length);



  13. newStream.Close();



  14. HttpWebResponse response = (HttpWebResponse)wb.GetResponse();



  15. Stream dataStream = response.GetResponseStream();



  16. StreamReader reader = new StreamReader(dataStream);



  17. return reader.ReadToEnd();



  18. }



  19. public string obj2json( object obj)



  20. {



  21. JavaScriptSerializer serializer = new JavaScriptSerializer();



  22. return serializer.Serialize(obj);



  23. }



  24. public string CallApi( string method, object param)



  25. {



  26. object Query = new



  27. {



  28. jsonrpc = "2.0" ,



  29. auth = auth_hash,



  30. id = id.ToString(),



  31. method = method,



  32. Params = param



  33. };



  34. String qr = obj2json(Query);



  35. qr=qr.Replace( "Params" , "params" );



  36. id++;



  37. string result = GetWebRequest(qr);



  38. return result;



  39. }





* This source code was highlighted with Source Code Highlighter .





CallAPI फ़ंक्शन फ़ंक्शन के लिए API कॉल करता है। एक विधि और इसके मापदंडों को स्वीकार करता है (Zabbix एपीआई प्रलेखन के अनुसार एक वस्तु के रूप में)। उपयोग के उदाहरण थोड़े कम होंगे। Obj2json का उद्देश्य, और GetWebRequest मुझे लगता है कि स्पष्ट है, मैं सिर्फ इतना जोड़ूंगा कि अनुरोध POST विधि का उपयोग करके भेजा गया है। सर्वर पर प्राधिकरण के उदाहरण के रूप में इस फ़ंक्शन के उपयोग पर विचार करें। प्राधिकरण के लिए, हमें उपयोगकर्ता और पासवर्ड मापदंडों के साथ "user.authenticate" विधि के लिए एक अनुरोध भेजने की आवश्यकता है। इसका परिणाम होगा, जो कि प्रत्येक बाद के अनुरोध का क्षेत्र है। प्राधिकरण के लिए एक तैयार कार्य, उपरोक्त बातों को ध्यान में रखते हुए, कुछ इस तरह दिखाई देगा:

  1. public bool login()



  2. {



  3. bool res;



  4. Update( new UpdateInfoMessage( this ) { message = " " , status = "LOGIN" });



  5. try



  6. {



  7. var userinfo = new { user = _user, password = _password };



  8. string result = CallApi( "user.authenticate" , userinfo);



  9. auth_hash = (serializer.Deserialize< string >(result)).result;



  10. res= true ;



  11. Update( new UpdateInfoMessage( this ) { message = " " , status = "LOGIN" });



  12. }



  13. catch (Exception ex)



  14. {



  15. Update( new UpdateInfoMessage( this ) { message = " :" + ex.Message, status = "LOGIN" });



  16. res= false ;



  17. }



  18. return res;



  19. }





* This source code was highlighted with Source Code Highlighter .





जैसा कि आप देख सकते हैं, तर्क बदसूरत सरल है, हम मापदंडों का वर्णन करते हैं, विधि का नाम निर्धारित करते हैं, फ़ंक्शन को कॉल करते हैं। अगर सबकुछ ठीक हो जाता है और वहाँ स्थित है, तो हम इसे कक्षा के वैश्विक क्षेत्र में सहेजते हैं और सकारात्मक परिणाम देते हैं। अगर कुछ गलत हुआ है - त्रुटि को पकड़ें और झूठ को वापस करें। यह अद्यतन फ़ंक्शन को भी ध्यान देने योग्य है - यह हमारी कक्षा में परिवर्तनों के मुख्य अनुप्रयोग को सूचित करने का कार्य करता है। इसलिए, हमने सीखा कि अनुरोध को कैसे पूरा किया जाए और सर्वर से सरल प्रतिक्रियाएं प्राप्त करें। लेकिन सर्वर से अधिकांश प्रतिक्रियाएं पूरी तरह से अलग तत्वों के सरणियां हैं। नई कार्यक्षमता को बढ़ाने के लिए, निम्न सामान्यीकृत वर्ग बनाया गया था:

  1. public class Result: IEnumerable

    {






    //





    public T[] result;





     





    ///





    public ZabbixConnection server;





     





    // Zabbix API, maps.get, triggers.update .





    protected string method;





     





    //





    protected object Params;





     





    // ,





    public string stringResult;





     





    // .





    public object SyncRoot;





     





     





    // , "method" "Params"





    protected virtual void init() { }





     





    public Result(ZabbixConnection Server)





    {





    init();





    server = Server;





    SyncRoot = new object ();





    }





    public Result()





    {





    init();





    }





     





    // , result collection





    public virtual void get ()





    {





    JavaScriptSerializer serializer = new JavaScriptSerializer();





    lock (SyncRoot)





    {





    stringResult = (server.CallApi(method, Params));





    result = serializer.Deserialize<Result>(stringResult).result;





    if (result== null ){result= new T[1];}





    }





    }





     





    public T this [ int index]





    {





    get





    {





    return result[index];





    }





    }





     





    public IEnumerator GetEnumerator()





    {





    foreach (T item in result)





    {





    yield return item;





    }





    }





    IEnumerator IEnumerable .GetEnumerator()





    {





    return GetEnumerator();





    }





    }











    , Zabbix API . , Init , . :





    1. using System;



    2. using System.Collections. Generic ;



    3. using System.Collections.ObjectModel;



    4. using System.Linq;



    5. using System.Text;



    6.  



    7. namespace Zabbix



    8. {



    9. public class Hosts:Result





      {





      protected override void init()





      {





      method = "host.get" ;





      Params = new { output = "extend" };





      }





       





      public Hosts(ZabbixConnection Server) : base (Server) { }





       





      }





      public class Host





      {





      public string host;





      public string hostid;





      public string ip;





      public override string ToString()





      {





      return host;





      }





      }





      }







    मुझे लगता है कि यहां सब कुछ काफी सरल है, उसी तरह आप किसी भी डेटा को प्राप्त कर सकते हैं, चाहे वह ट्रिगर, होस्ट समूह, ईवेंट या शेड्यूल डेटा हो। सभी तरीकों और मापदंडों के विवरण Zabbix एपीआई प्रलेखन अनुभाग में पाए जा सकते हैं। मैं इस विषय को महसूस करता हूं और यह छोटा नहीं निकला है, और इसे समाप्त करने का समय आ गया है। मैंने .NET अनुप्रयोगों में Zabbix API का उपयोग करने के तरीके के बारे में जितना संभव हो उतना कम वर्णन किया है। अधिक पूर्ण लाइब्रेरी कोड, साथ ही WPF पर एक उदाहरण क्लाइंट, यहां डाउनलोड किया जा सकता है: https://github.com/p1nger/odzl



All Articles