åœç€Ÿã®ã¢ãã¿ãªã³ã° ãœãªã¥ãŒã·ã§ã³ãš API ã¯ãAPI ããŒã䜿çšã㊠ID ãèªèšŒããã³æ€èšŒããŸãããããã®ããŒã«ãããçµç¹å
ã®æ¿èªããã人ã ããããŒã¿ã New Relic ã«å ±åãããã®ããŒã¿ã«ã¢ã¯ã»ã¹ããæ©èœãæ§æããããšãã§ããŸãããã©ã€ã㪠ããŒã¯ãã©ã€ã»ã³ã¹ ã㌠(ã¬ããŒã ããŒã¿çš) ãšãŠãŒã¶ãŒ ã㌠(GraphQL API ã§ãã NerdGraph ãæäœãããã) ã§ãã
API ããŒã®äœ¿çšãéå§ããã«ã¯:
ãŸã ãæã¡ã§ãªãå Žåã¯ãç¡æã¢ã«ãŠã³ãã«ãµã€ã³ã¢ããããŠãã ãã ãšãŒãžã§ã³ããšçµ±å ã䜿çšããŠãNew Relic ãžã®ããŒã¿ã®åã蟌ã¿ãéå§ããŸãAPI ã㌠UI ããŒãž ãã API ããŒãäœæããã³ç®¡çããŠãããŒã¿ã®ç£èŠãããã«éå§ã§ããããã«ããŸã 䞻㪠API ã㌠API ã㌠éµ
詳现
衚瀺 管çããã«ã¯
ç¶ããèªã
ã©ã€ã»ã³ã¹ã㌠, ããŒã¿åã蟌ã¿ã«äœ¿çšãããŸãã
ã©ã€ã»ã³ã¹ããŒã¯ãã»ãŒãã¹ãŠã®ããŒã¿ã®å ±åã«äœ¿çšãããŸãïŒç¬èªã®ããŒã䜿çšãããã©ãŠã¶ããã³ã¢ãã€ã«ã¢ãã¿ãªã³ã°ããŒã¿ãé€ãïŒãåããŒã¯ç¹å®ã®ã¢ã«ãŠã³ãã«é¢é£ä»ããããå¿
èŠãªæ°ã ãäœæããããšãã§ããŸãã
APIããŒã®UIïŒçŽãªã³ã¯ ïŒã«ç§»åããŸãã
ãã£ãšè©³ããç¥ã
ãã©ãŠã¶ã®ã㌠ãããŒã¿åã蟌ã¿ã«äœ¿çšãããã
ãã©ãŠã¶ããŒã¯ã ãã©ãŠã¶ã¢ãã¿ãªã³ã° ããŒã¿ãå ±åããããã«äœ¿çšãããŸããåããŒã¯ç¹å®ã®ã¢ã«ãŠã³ãã«é¢é£ä»ããããå¿
èŠãªæ°ã ãäœæããããšãã§ããŸãã
APIããŒã®UIïŒçŽãªã³ã¯ ïŒã«ç§»åããŸãã
ãã£ãšè©³ããç¥ã
ã¢ãã€ã«ã¢ããªã®ããŒã¯ã³ ãããŒã¿åã蟌ã¿ã«äœ¿çšã
ã¢ãã€ã«ã¢ããªããŒã¯ã³ã¯ã ã¢ãã€ã«ã¢ãã¿ãªã³ã° ã®ããŒã¿ãå ±åããããã«äœ¿çšãããŸããåããŒã¯ã³ã¯ãç¹å®ã®ã¢ãã€ã«ã¢ããªã«é¢é£ä»ããããŠããŸãã
ç£èŠå¯Ÿè±¡ã¢ããªã®UIã«ç§»åãã
ãã£ãšè©³ããç¥ã
ãŠãŒã¶ãŒã㌠ãåãåãããšã³ã³ãã£ã®ã¥ã¬ãŒã·ã§ã³ã«äœ¿çšãããã
ããŒã¿ã®ã¯ãšãªãšæ©èœã®æ§æã«äœ¿çšããã GraphQL API ã§ããNerdGraph ã䜿çšããã«ã¯ããŠãŒã¶ãŒ ããŒãå¿
èŠã§ããåãŠãŒã¶ãŒ ããŒã¯ãç¹å®ã®ãŠãŒã¶ãŒã«é¢é£ä»ããããŠããŸãã
APIããŒã®UIïŒçŽãªã³ã¯ ïŒã«ç§»åããŸãã
ãã£ãšè©³ããç¥ã
APIããŒã®è¡šç€ºãšç®¡ç ã»ãšãã©ã® API ããŒã¯ã API ã㌠UI ããŒãž ãã衚瀺ããã³ç®¡çã§ããŸãã ãããèŠã€ããã«ã¯: ãŠãŒã¶ãŒ ã¡ãã¥ãŒ ãã API ã㌠ãã¯ãªãã¯ããŸãã ããªããããããšãã§ããŸãïŒ
ã¢ã«ãŠã³ã ID ã¯ãNew Relic ã«ããŒã¿ãå ±åããããã«ãã°ãã°å¿
èŠãšãªãå¥ã®èå¥çªå·ã§ãã
UI ããã®ããŒã®ã³ã㌠API ã㌠UI ããŒãž ããæ¢åã® API ããŒãã³ããŒããããšãã§ããŸããUI ã§äœ¿çšãããèšèªã®è©³çŽ°ãæ¬¡ã«ç€ºããŸãã
ã㌠ã®ã³ããŒãšã㌠ID ã®ã³ã㌠: æåã®ãªãã·ã§ã³ã¯ãããŒèªäœã®å€ãã³ããŒããŸããã»ãšãã©ã®å Žåãããã䜿çšããŸãã2 çªç®ã®ãªãã·ã§ã³ã¯ãããŒã® ID ãã³ããŒããŸããããã¯ãAPI ãä»ããŠã㌠ãªããžã§ã¯ããåç
§ããããã«å¿
èŠã«ãªãå ŽåããããŸããCopy truncated key : ãã®ãªãã·ã§ã³ã¯ãèªåã®ãã®ã§ã¯ãªãããŒã«äœ¿çšã§ããŸããããŒããæ°æ¡ããã³ããŒãããªããããããŒã®å
éšè¿œè·¡ããµããŒããšã®äŒè©±ã«åœ¹ç«ã¡ãŸãã APIããŒã®å®å
šæ§ã確ä¿ãã APIããŒãæªçšããããšãã»ãã¥ãªãã£äžã®ãªã¹ã¯ãçºçããå¯èœæ§ããããŸããäŸãã°
ããªãã®èª°ã
ã¢ã«ãŠã³ãã®ã©ã€ã»ã³ã¹ã㌠ã¢ã«ãŠã³ãã«ä»»æã®ããŒã¿ãéä¿¡ããå¯èœæ§ããããŸãã
ããŒã ã¡ã³ããŒã®ãŠãŒã¶ãŒããŒã®ãããããæã€èª°ãããã客æ§ã® New Relic ããŒã¿ãé²èЧããã客æ§ã® New Relic ã¢ã«ãŠã³ãã«å€æŽãå ããããšãã§ããŸãã
APIããŒã¯ããã¹ã¯ãŒãããã®ä»ã®æ©å¯æ
å ±ãšåæ§ã«ãå®å
šã«åãæ±ãå¿
èŠããããŸããããã€ãã®æšå¥šäºé
ã玹ä»ããŸãã
ã©ã€ã»ã³ã¹ããŒãšãã©ãŠã¶ããŒã«ã€ããŠã¯ãäžå®ã®ã¹ã±ãžã¥ãŒã«ã§æ°ããããŒãäœæããå€ãããŒãåé€ãããããŒããŒããŒã·ã§ã³æŠç¥ã®å®æœãæ€èšããŠãã ãããèæ
®ããããšã
ã¢ã«ãŠã³ãã«é¢é£ä»ãããããªãªãžãã«ã®ããŒã¯åé€ã§ããªãã®ã§ã匷åãªã»ãã¥ãªãã£æŠç¥ã宿œããããã«ã¯ãåŸã§åé€ã§ããããŒã远å ã§äœæããå¿
èŠããããŸãã ãªããã¢ãã€ã«ã¢ããªã®ããŒã¯ã³ã«ã¯é©çšãããŸãããããŒã¯ã³ãåé€ãããã远å ã§äœæãããããããšã¯ã§ããŸããã ãŠãŒã¶ãŒããŒã®å Žåã
ãŠãŒã¶ãŒããŒãå®å
šã«ä¿ç®¡ãããããããŒã ã¡ã³ããŒã«æå°ããã ã¡ã³ããŒãçµç¹ãé¢ãããšãã¯ãããšã åºæ¬ãŠãŒã¶ãŒã§ãã£ãŠã ãNew Relic ããåé€ããŸãã APIããŒã«ã€ããŠãã£ãšèªã APIããŒãäœæãŸãã¯ç®¡çããã«ã¯ãone.newrelic.com / launcher / api-keys-ui.api-keys-launcherã®UIããŸãã¯NerdGraphAPI ã䜿çšããŸã ã詳现ã«ã€ããŠã¯ãããŒãéžæããŠãã ããã
ã©ã€ã»ã³ã¹ã㌠ããŒã¿ã®åã蟌ã¿ã«äœ¿çšãããã¡ã€ã³ããŒã¯ãã©ã€ã»ã³ã¹ããŒãšåŒã°ããŸãã APIããŒUIããã³NerdGraph ã§ã¯ããã®ããŒã¯ingest - license
ãšããŠåç
§ãããããšããããŸãã
ã»ãšãã©ãã¹ãŠã®NewRelicããŒã¿ãåã蟌ãã«ã¯ãã©ã€ã»ã³ã¹ããŒãå¿
èŠã§ããäŸå€ã¯ããã©ãŠã¶ãŒç£èŠããŒã¿ïŒãã©ãŠã¶ãŒããŒã䜿çšïŒãšã¢ãã€ã«ç£èŠããŒã¿ïŒã¢ãã€ã«ã¢ããªããŒã¯ã³ã䜿çšïŒã§ãã
ã©ã€ã»ã³ã¹ããŒã¯ãNewRelicã¢ã«ãŠã³ãã«é¢é£ä»ãããã40æåã®16鲿ååã§ãã New Relicã«åããŠãµã€ã³ã¢ãã ãããšãåäžã®ã¢ã«ãŠã³ããšç¬èªã®ã©ã€ã»ã³ã¹ããŒãæã€çµç¹ãäœæãããŸããããã«ã¢ã«ãŠã³ãã远å ããããšãåã¢ã«ãŠã³ãã¯ç¬èªã®ã©ã€ã»ã³ã¹ããŒã§å§ãŸããŸããã¢ã«ãŠã³ãçšã«æåã«äœæãããã©ã€ã»ã³ã¹ããŒã¯åé€ã§ããŸãããã管çããã³åé€ã§ãã远å ã®ã©ã€ã»ã³ã¹ããŒãäœæã§ããŸããããã¯ãããŒããŒããŒã·ã§ã³ãªã©ã®ã»ãã¥ãªãã£ãã©ã¯ãã£ã¹ãå®è£
ããã®ã«åœ¹ç«ã¡ãŸããã¢ã«ãŠã³ãã®å
ã®ã©ã€ã»ã³ã¹ããŒãåé€ããå¿
èŠãããå Žåã¯ããµããŒãã«é£çµ¡ã㊠ãã ããã
ãŠãŒã¶ãŒãã©ã€ã»ã³ã¹ããŒã衚瀺ãŸãã¯ç®¡çã§ããªãããã«å¶éããã«ã¯ããããã®æ©èœãæããªãããŒã«ããŠãŒã¶ãŒ ã«å²ãåœãŠãŸããæ°ãããŠãŒã¶ãŒã¢ãã« ã
ãã©ãŠã¶ã㌠ãã©ãŠã¶ã®ç£èŠã§ã¯ãã©ã€ã»ã³ã¹ããŒã§ã¯ãªãããã©ãŠã¶ããŒã䜿çšããŠããŒã¿ãå ±åããŸãããã©ãŠã¶ããŒã¯ããã©ãŠã¶ç£èŠãšãŒãžã§ã³ã ããã®ããŒã¿ãã¢ã«ãŠã³ãã«é¢é£ä»ããããã«äœ¿çšãããŸãã
ã¢ã«ãŠã³ãäœææã«äœæããããªãªãžãã«ã®ãã©ãŠã¶ããŒã管çã»åé€ããããšã¯ã§ããŸããããæ°ãããã©ãŠã¶ããŒãäœæãããã®ããŒãåé€ããããšã¯å¯èœã§ããã¢ã«ãŠã³ãã®æåã®ãã©ãŠã¶ããŒãåé€ããæ¹æ³ã«ã€ããŠã¯ã ãµããŒãã«ãåãåãããã ããã .
ã¢ãã€ã«ã¢ããªããŒã¯ã³ ã¢ãã€ã«ã¢ãã¿ãªã³ã°ã§ã¯ãã©ã€ã»ã³ã¹ããŒã§ã¯ãªããã¢ãã€ã«ã¢ããªããŒã¯ã³ã䜿çšããŠããŒã¿ãã¬ããŒãããŸãã詳现ã«ã€ããŠã¯ãã¢ãã€ã«ã¢ããªããŒã¯ã³ ãåç
§ããŠãã ããã
ãŠãŒã¶ãŒã㌠New Relic ã®ãŠãŒã¶ãŒã㌠("åäººçš API ããŒãšåŒã°ããããšããããŸã)" ã¯ã NerdGraph ãšåŒç€Ÿã® REST API ã䜿çšããéã«å¿
èŠã§ãã
ãŠãŒã¶ãŒããŒã¯ç¹å®ã® New Relic ãŠãŒã¶ãŒã«é¢é£ä»ããããŠãããè²æž¡ããããšã¯ã§ããŸããããŠãŒã¶ãŒ ããŒã䜿çšãããšãããŒãé¢é£ä»ããããç¹å®ã®ã¢ã«ãŠã³ãã ãã§ãªããã¢ã¯ã»ã¹ãèš±å¯ããããã¹ãŠã®ã¢ã«ãŠã³ãã«å¯Ÿã㊠NerdGraph ã¯ãšãªãšãã¥ãŒããŒã·ã§ã³ãå®è¡ã§ããŸããNew Relic ã§ New Relic ãŠãŒã¶ãŒãåé€ããããšããã®ãŠãŒã¶ãŒ ããŒãéã¢ã¯ãã£ãåãããæ©èœããªããªããŸãã
è€æ°ã®ã¢ã«ãŠã³ããžã®ãŠãŒã¶ãŒ ã¢ã¯ã»ã¹ãæäŸããŸããããŠãŒã¶ãŒ ããŒã¯ 1 ã€ã®ç¹å®ã®ã¢ã«ãŠã³ãã«ãªã³ã¯ãããŸãããããéèŠãªã®ã¯ãã¢ã«ãŠã³ããåé€ããããšããã®ã¢ã«ãŠã³ãã«é¢é£ä»ããããŠãããŠãŒã¶ãŒ ããŒãæ©èœããªããªãããšã§ããããã«ãREST API åŒã³åºãã¯ããŠãŒã¶ãŒ ããŒã«é¢é£ä»ããããã¢ã«ãŠã³ãã®ã³ã³ããã¹ãã«éå®ãããŸãã
ãŠãŒã¶ãŒããŠãŒã¶ãŒ ããŒã衚瀺ãŸãã¯ç®¡çã§ããªãããã«ããã«ã¯ããããã®æ©èœãæããªãããŒã«ããŠãŒã¶ãŒã«å²ãåœãŠãŸã ãæ°ãããŠãŒã¶ãŒ ã¢ãã« ã
äžèšã§èª¬æããäž»èŠãª API ããŒã«å ããŠãäžéšã® New Relic ã®ã客æ§ããŸã 䜿çšããŠããå€ã API ããŒãä»ã«ãããã€ããããŸãããããã®ããŒããŸã 䜿çšããŠããªãå Žåã¯ãããããéå§ããå¿
èŠã¯ãããŸããã
ãã®ä»ã® API ã㌠ã€ã³ãµã€ãã€ã³ãµãŒãããŒïŒéæšå¥šïŒ éèŠ ãã®ããŒã¯ãŸã 䜿çšãããŠããŸããã ã¢ã«ãŠã³ãã®ã©ã€ã»ã³ã¹ã㌠ãåããã®ãªã©ã«äœ¿çšã§ããŸãã
ããŒã¿ã®åã蟌ã¿ã«äœ¿çšãããå€ãNewRelicAPIããŒã®1ã€ã¯ãInsightsæ¿å
¥ããŒïŒæ¿å
¥ããŒãšãåŒã°ããŸãïŒã§ããã©ã€ã»ã³ã¹ããŒã¯åãæ©èœãªã©ã«äœ¿çšãããããšã«æ³šæããŠãã ããããã®ããããã®ããŒãããã©ã€ã»ã³ã¹ããŒããå§ãããŸãã
ãã®ããŒã¯ãåœç€Ÿã® Event API ã Log API ã Metric API ãããã³ Trace API ããŸãã¯ãããã® API ã䜿çšããçµ±åãçµç±ããŠããŒã¿ãåã蟌ãããã«äœ¿çšãããŸãã
空ãç¶æ³ãã¢ã¯ã»ã¹ã«é¢ãããã³ã
ãããã®ããŒã¯ãç¹å®ã®ãŠãŒã¶ãŒã§ã¯ãªãã¢ã«ãŠã³ãã«é¢é£ä»ããããŠãããããããŒã«ã¢ã¯ã»ã¹ã§ããã¢ã«ãŠã³ãã®èª°ãã䜿çšããããšãã§ããŸãã
ã»ãã¥ãªãã£ã®ããã®ãã¹ããã©ã¯ãã£ã¹ãšããŠãã¢ããªã±ãŒã·ã§ã³ãããŒã¿ãœãŒã¹ããšã«ç°ãªãInsightsã®æ¿å
¥ããŒã䜿çšããããšããå§ãããŸãã
Insights æ¿å
¥ããŒãèŠã€ããŠç®¡çããã«ã¯:ãŠãŒã¶ãŒ ã¡ãã¥ãŒ ããã[ API ã㌠] ãã¯ãªãã¯ããŸã ( API ã㌠ããŒãžãžã®çŽæ¥ãªã³ã¯ã ååŸããŸã)ãæ¬¡ã«ã Insights ã®æ¿å
¥ã㌠ã ã¯ãªãã¯ããŸãã
ã€ã³ãµã€ãã®ã¯ãšãªãŒããŒïŒéæšå¥šïŒ 管çããŒ(éæšå¥š) adminããŒã¯ã廿¢ãããå€ãAPIããŒã®1ã€ã§ãã 2020幎12æ4æ¥ã®æç¹ã§ãæ¢åã®ãã¹ãŠã®ç®¡çè
ããŒããŠãŒã¶ãŒããŒã«ç§»è¡ãããŠããŸãã
管çè
ããŒã䜿çšããŠããå Žåããã®ããŒãæå¹ã«ããããã«äœãããå¿
èŠã¯ãããŸãããAPIããŒã®UIããèªåçã«ã¢ã¯ã»ã¹ã§ããããã«ãªãããŠãŒã¶ãŒããŒãšããŠã©ãã«ä»ããããåãããŒããã·ã§ã³ãä»äžãããŸãããŠãŒã¶ãŒããŒãšåãããã«ãåãã¯ãŒã¯ãããŒã§ç®¡çããããšãã§ããŸãã
ç§»è¡ããããã¹ãŠã®ç®¡çè
ããŒã«ã¯ãããŒããŒãã«ã®ç®¡çè
ãŠãŒã¶ãŒããŒãã ç§»è¡ããããšããã¡ã¢ããããŸãã
REST APIããŒïŒéæšå¥šïŒ REST APIããŒã¯ã RESTAPI ã䜿çšããããã®å€ãããŒã§ããçŸåšãRESTAPIããŒã®ä»£ããã«ãŠãŒã¶ãŒããŒã䜿çšããããšããå§ãããŸãã ãŠãŒã¶ãŒã¯ã¢ã«ãŠã³ãåºæã§ã¯ãªããŠãŒã¶ãŒåºæã§ãããããçµç¹ã¯ããŒã ã¡ã³ããŒã®ã¢ã¯ã»ã¹ããã现ããå¶åŸ¡ã§ããŸãããŸããREST APIã®ä»£ããã«ãæ°ããAPIã§ããNerdGraph ã䜿çšããããšããå§ãããŸãã
èæ
®ãã¹ãããš
åNewRelicã¢ã«ãŠã³ãã¯ãRESTAPIããŒã1〠ã ãæã€ããšãã§ããŸãã
RESTAPIããŒã®ä»£ããã«ãŠãŒã¶ãŒããŒã䜿çšããããšããå§ãããŸãã
å¯èœã§ããã°ãREST API ãã NerdGraph ã䜿çšããããšããå§ãããŸãã
管çè
ã¬ãã«ã®ãŠãŒã¶ãŒæš©éãå¿
èŠã§ãã RESTAPIããŒãŸãã¯RESTAPIãšã¯ã¹ãããŒã©ãŒã«ã¢ã¯ã»ã¹ã§ããªãå Žåã¯ãæš©éããªãããšãåå ã§ããå¯èœæ§ããããŸãã New Relicã¢ã«ãŠã³ããããŒãžã£ãŒã«çžè«ãããã代ããã«ãŠãŒã¶ãŒããŒã䜿çšããŠãã ããã
REST API ããŒãèŠã€ããŠç®¡çããã«ã¯:ãŠãŒã¶ãŒ ã¡ãã¥ãŒ ããã[ API ã㌠] ãã¯ãªãã¯ããŸã ( API ã㌠ããŒãžãžã®çŽæ¥ãªã³ã¯ã ååŸããŸã)ãæ¬¡ã«ã REST API ã㌠ã ã¯ãªãã¯ããŸããAPI ããŒãæ§æãŸãã¯åé€ããåã«ãæ£ããã¢ã«ãŠã³ãã«å¯ŸããŠè¡ã£ãŠããããšã確èªããŠãã ããã
èªåã§ New Relic ãè©Šãæºåã¯ã§ããŸããã?ç¡æã® New Relic ã¢ã«ãŠã³ãã«ãµã€ã³ã¢ãããã ã¯ã€ã㯠ããŒã³ã ã¬ã€ã ã«åŸã£ãŠãã ãããä»ããããŒã¿ãæå€§éã«æŽ»çšã§ããããã«ãªããŸãã