معیارها را با میکرون جمع کنید

بیاموزید که چگونه می توانید معیارهای استاندارد و سفارشی را با چارچوب Micronaut جمع آوری کنید.

نویسندگان: برت بکوییت

نسخه میکرون: 3. 7. 3

1. شروع کار

در این راهنما ، ما یک برنامه Micronaut ایجاد خواهیم کرد که در Groovy نوشته شده است.

ما از میکرونوت میکرومتر برای افشای داده های متریک کاربرد با میکرومتر استفاده خواهیم کرد.

2. آنچه شما نیاز خواهید داشت

برای تکمیل این راهنما ، به موارد زیر نیاز خواهید داشت:

مدتی روی دستان شما

ویرایشگر متن مناسب یا IDE

JDK 1. 8 یا بیشتر نصب شده با Java_Home به طور مناسب پیکربندی شده است

3. راه حل

توصیه می کنیم دستورالعمل ها را در بخش های بعدی دنبال کنید و برنامه را به صورت مرحله به مرحله ایجاد کنید. با این حال ، شما می توانید درست به مثال کامل بروید.

منبع را بارگیری و از حالت فشرده خارج کنید

4. نوشتن برنامه

دستور قبلی یک برنامه Micronaut با مثال بسته بندی پیش فرض ایجاد می کند. Micronaut در دایرکتوری به نام MicronAutguide.

اگر از Micronaut Launch استفاده می کنید ، برنامه Micronaut را به عنوان نوع برنامه انتخاب کرده و میکرومتر-آنوتاسیون ، Data-JDBC و ویژگی های Flyway را اضافه کنید.

4. 1پیکربندی معیارها

چندین گروه از معیارها به طور پیش فرض فعال می شوند. این موارد شامل معیارهای سیستم (اطلاعات JVM ، به موقع و غیره) و همچنین درخواست های وب ردیابی معیارها ، فعالیت داده های داده و سایر موارد است. معیارهای کلی می توانند فعال یا غیرفعال شوند و گروه ها می توانند به صورت جداگانه در پیکربندی فعال یا غیرفعال شوند.

موارد زیر را به Application. yml اضافه کنید:

4. 2معیارهای سفارشی

اگر معیارهای داخلی کافی نیستند ، می توانید به راحتی معیارهای سفارشی را با حاشیه نویسی های زیر اضافه کنید.

یک متریک تایمر ایجاد می کند که شامل کل زمان ، حداکثر زمان و تعداد است.

یک متریک پیشخوان ایجاد می کند که فقط حاوی شمارش است.

اگر می خواهید سنج خود را ایجاد کنید ، می توانید io. micrometer. core. instrument. meterregistry را به لوبیا خود تزریق کنید.

4. 3معیارهای منبع داده

در صورت استفاده از Hikaricp (پیش فرض) ، Tomcat JDBC یا استخر اتصال Commons DBCP ، معیارهای DataSource به طور پیش فرض فعال می شوند.

4. 4مهاجرت پایگاه داده با Flyway

ما به راهی برای ایجاد طرح پایگاه داده نیاز داریم. برای این کار ، ما از ادغام میکرون با Flyway استفاده می کنیم.

Flyway تغییرات طرحواره ای را به طور قابل توجهی انجام می دهد ، به طور قابل توجهی وظایف مدیریت طرحواره مانند مهاجرت ، چرخش به عقب و تولید مثل در چندین محیط را ساده می کند.

قطعه زیر را اضافه کنید تا وابستگی های لازم را شامل شود:

ما Flyway را در Application. yml فعال می کنیم و آن را پیکربندی می کنیم تا مهاجرت ها را در یکی از منابع داده تعریف شده انجام دهد.

مهاجرت Flyway به طور خودکار قبل از شروع برنامه میکرونوت شما انجام می شود. Flyway دستورات مهاجرت را در منابع/db/مهاجرت/فهرست می خواند ، در صورت لزوم آنها را اجرا می کند و تأیید می کند که منبع داده پیکربندی شده با آنها سازگار است.

فایل های مهاجرتی زیر را با ایجاد طرحواره پایگاه داده ایجاد کنید:

در طول راه اندازی برنامه، Flyway فایل SQL را اجرا می کند و طرح مورد نیاز برای برنامه را ایجاد می کند.

4. 5. دامنه

یک کلاس دامنه Book ایجاد کنید که از Micronaut Data JDBC استفاده می کند:

4. 6. مخزن کتاب

سپس، رابط BookRepository را برای تعریف عملیات پایگاه داده ایجاد کنید. Micronaut Data رابط را در زمان کامپایل پیاده سازی می کند:

4. 7. کلاس جمع کننده داده

یک کلاس DataPopulator برای ایجاد چند نمونه از ورودی های پایگاه داده هنگام شروع برنامه ایجاد کنید:

4. 8. BookController

برای دسترسی به نمونه های کتاب (و راه اندازی داده های متریک JDBC)، BookController ایجاد کنید:

4. 9. معیارهای سفارشی

برای مشاهده معیارهای سفارشی در عمل، سرویسی ایجاد کنید که به صورت دوره ای قیمت فعلی بیت کوین را به دلار با استفاده از REST بازیابی می کند.

4. 9. 1. مدل

برای نمایش پاسخ REST به یک کلاس داده نیاز داریم. کلاس BitcoinPrice را ایجاد کنید:

4. 9. 2. مشتری HTTP اعلامی Kucoin

رابط کاربری Micronaut HTTP Client اعلامی ایجاد کنید که در زمان کامپایل پیاده سازی می شود:

4. 9. 3. پیکربندی سرویس HTTP

برای پیکربندی URL برای شناسه سرویس kucoin، application. yml را تغییر دهید:

4. 9. 4. سرویس

یک کلاس CryptoService ایجاد کنید که از PriceClient استفاده می کند و سه متر سفارشی را به روز می کند:

5. آزمایش برنامه

فایل پیکربندی src/test/resources/application-test. yml را برای تست ها ایجاد کنید.

یک کلاس آزمایشی برای تأیید عملکرد معیارها ایجاد کنید:

یک کلاس آزمایشی اضافی برای تأیید معیارهای سفارشی ایجاد کنید:

تست قبلی دو سرور جاسازی شده Micronaut ایجاد می کند. یکی API kucoin را مسخره می کند، دیگری برنامه ما است. این آزمایش از @Requires برای بارگذاری شرطی یک کنترلر فقط برای زمینه کوکوین bean استفاده می کند. ما از یک شناسه با @Client استفاده کردیم که به راحتی می‌توان مشتری HTTP خود را به سرور ساختگی اشاره کرد.

5. 1. اجرای تست ها

برای اجرای تست ها:

سپس build/reports/tests/test/index. html را در مرورگر باز کنید تا نتایج را ببینید.

6. اجرای برنامه

برای اجرای برنامه از دستور ./gradlew run استفاده کنید که برنامه را روی پورت 8080 راه اندازی می کند.

متناوبا، برای اینکه به‌روزرسانی قیمت بیت‌کوین به‌طور مکرر انجام شود تا تأثیرات آن روی معیارها مشاهده شود، برنامه را با یک تغییر پیکربندی شروع کنید تا هر پنج ثانیه یک‌بار به‌روزرسانی شود:

با استفاده از cURL می توانید فهرستی از معیارهای شناخته شده را بازیابی کنید:

پاسخ باید به شکل زیر باشد:

پس از اینکه برنامه برای مدتی اجرا شد و چند بررسی قیمت بیت کوین انجام داد، می توانیم مقادیر متریک مربوطه را مشاهده کنیم: