الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

CW

CW - أفضل طريقة لذيل سجلات AWS CloudWatch

أفضل طريقة لذيل سجلات AWS CloudWatch من المحطة الخاصة بك.

مؤلف - لوكا جرولا - https://www.lucagrulla.com

  • سمات
  • تثبيت
  • الأوامر والخيارات
  • أمثلة
  • بيانات اعتماد AWS والتكوين
  • متنوع
  • ملاحظات الإصدار

سمات

  • لا تبعيات خارجية
    • CW هو مواطن قابل للتنفيذ يستهدف نظام التشغيل الخاص بك. لا PIP ، NPM ، Rubygems.
  • سريع .
    • CW مكتوبة في Golang وتجميعها ضد الهندسة المعمارية الخاصة بك.
  • تاريخ ووقت مرن .
    • العمل مع المنطقة الزمنية Local أو UTC (افتراضي).
    • تحليل مرن.
      • تنسيقات صديقة للإنسان ، أي 2d1h20m للإشارة إلى يومين ، ساعة واحدة و 20 دقيقة.
      • ساعة محددة ، أي 13:10 للإشارة إلى 13:10 من اليوم.
      • طابع زمني كامل 2018-10-20T8:53 .
  • مجموعات سجل متعددة
    • ذيل مجموعات سجل متعددة بالتوازي: cw tail my-auth-service my-web .
  • GREP القوي المدمج ( --grep ) و grepv ( --grepv ).
  • دعم jmespath لاستفسارات JSON (مطابقة علم AWS CLI --query )
  • مشغل الأنابيب المدعوم
    • echo my-group | cw tail و cat groups.txt | cw tail .
  • مشغل إعادة التوجيه >> مدعوم
    • cw tail -f my-stream >> myfile.txt .
  • الإخراج الملون
    • --no-color بلون لتعطيل إذا لزم الأمر.
  • السيطرة على بيانات الاعتماد المرنة.
    • بشكل افتراضي ، يتم استخدام AWS .AWS/بيانات الاعتماد وملفات .AWS/الملف الشخصي . يمكن تحقيق التجاوزات مع علامات --profile و --region .

تثبيت

ماك OSX

باستخدام البيرة 

brew tap lucagrulla/tap
brew install cw

Linux

باستخدام Linuxbrew 

brew tap lucagrulla/tap
brew install cw

.deb/.rpm

قم بتنزيل .deb أو .rpm من صفحة الإصدارات وتثبيتها باستخدام dpkg -i و rpm -i على التوالي.

باستخدام snapcraft.io

ملاحظة : إذا قمت بالترقية إلى 3.3.0 ، يرجى ملاحظة أمر الاسم المستعار الجديد. هذا مطلوب للامتثال لقواعد إصدار Snapcraft الجديدة. 

snap install cw-sh
sudo snap connect cw-sh:dot-aws-config-credentials
sudo snap alias cw-sh.cw cw

يعمل cw مع الحبس الصارم. مطلوب اتصال واجهة dot-aws-config-credentials للوصول إلى ملفات .aws/config و .aws/credentials

على Windows

باستخدام scoop.sh 

scoop bucket add cw https://github.com/lucagrulla/cw-scoop-bucket.git
scoop install cw

اذهب الأدوات 

go get github.com/lucagrulla/cw

الأوامر والخيارات

أعلام عالمية

  • --profile=profile-name يتجاوز ملف تعريف AWS المستخدم للاتصال.
  • --region=aws-region تجاوز منطقة AWS المستهدفة.
  • --no-color تعطيل الإخراج الملون.
  • --endpoint الهدف URL AWS نهاية نقطة النهاية. بشكل افتراضي سيستخدم CW نقاط نهاية AWS الافتراضية.
  • --no-version-check تتجاهل التحقق من التحقق إذا كان هناك إصدار أحدث من الوحدة متوفرة.

الأوامر

  • cw ls اذكر جميع مجموعات السجل/تدفقات السجل داخل المجموعة 

     Usage: cw ls <command>

show an entity

Flags:
  -h, --help               Show context-sensitive help.
      --endpoint=URL       The target AWS endpoint url. By default cw will use the default aws endpoints. NOTE: v4.0.0
                          dropped the flag short version.
      --profile=PROFILE    The target AWS profile. By default cw will use the default profile defined in the
                          .aws/credentials file. NOTE: v4.0.0 dropped the flag short version.
      --region=REGION      The target AWS region. By default cw will use the default region defined in the
                          .aws/credentials file. NOTE: v4.0.0 dropped the flag short version.
      --no-color           Disable coloured output.NOTE: v4.0.0 dropped the flag short version.
      --version            Print version information and quit
      --no-version-check   Ignore checks if a newer version of the module is available.

Commands:
  ls groups
    Show all groups.

  ls streams <group>
    Show all streams in a given log group.

cw: error: expected one of "groups",  "streams"

  • cw tail Tail مجموعة سجل/دفق السجل معين 

     Usage: cw tail <groupName[:logStreamPrefix]> ...

Tail log groups/streams.

Arguments:
  <groupName[:logStreamPrefix]> ...    The log group and stream name, with group:prefix syntax. Stream name can be just the prefix. If no stream name is specified all stream names in the given
                                      group will be tailed. Multiple group/stream tuple can be passed. e.g. cw tail group1:prefix1 group2:prefix2 group3:prefix3.

Flags:
  -h, --help                           Show context-sensitive help.
      --endpoint=URL                   The target AWS endpoint url. By default cw will use the default aws endpoints. NOTE: v4.0.0 dropped the flag short version.
      --profile=PROFILE                The target AWS profile. By default cw will use the default profile defined in the .aws/credentials file. NOTE: v4.0.0 dropped the flag short version.
      --region=REGION                  The target AWS region. By default cw will use the default region defined in the .aws/credentials file. NOTE: v4.0.0 dropped the flag short version.
      --no-color                       Disable coloured output.NOTE: v4.0.0 dropped the flag short version.
      --version                        Print version information and quit
      --no-version-check               Ignore checks if a newer version of the module is available.

  -f, --follow                         Don't stop when the end of streams is reached, but rather wait for additional data to be appended.
  -t, --timestamp                      Print the event timestamp.
  -i, --event-id                       Print the event Id.
  -s, --stream-name                    Print the log stream name this event belongs to.
  -n, --group-name                     Print the log group name this event belongs to.
  -r, --retry                          Keep trying to open a log group/log stream if it is inaccessible.
  -b, --start="2021-04-11T08:21:52"    The UTC start time. Passed as either date/time or human-friendly format. The human-friendly format accepts the number of days, hours and minutes prior to
                                      the present. Denote days with 'd', hours with 'h' and minutes with 'm' i.e. 80m, 4h30m, 2d4h. If just time is used (format: hh[:mm]) it is expanded to
                                      today at the given time. Full available date/time format: 2017-02-27[T09[:00[:00]].
  -e, --end=STRING                     The UTC end time. Passed as either date/time or human-friendly format. The human-friendly format accepts the number of days, hours and minutes prior to the
                                      present. Denote days with 'd', hours with 'h' and minutes with 'm' i.e. 80m, 4h30m, 2d4h. If just time is used (format: hh[:mm]) it is expanded to today at
                                      the given time. Full available date/time format: 2017-02-27[T09[:00[:00]].
  -l, --local                          Treat date and time in Local timezone.
  -g, --grep=STRING                    Pattern to filter logs by. See http://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html for syntax.
  -v, --grepv=STRING                   Equivalent of grep --invert-match. Invert match pattern to filter logs by.
  -q, --query=STRING                   Equivalent of the --query flag in AWS CLI. Takes a JMESPath expression to filter JSON logs by. If the query fails (e.g. the log message was not JSON) then the original line is returned.

أمثلة

  • قائمة مجموعات السجل المتاحة

    • cw ls groups

  • قائمة تدفقات السجل في مجموعة سجل معينة

    • cw ls streams my-log-group

  • الذيل واتبع مجموعات السجل/التدفقات المعطاة

    • cw tail -f my-log-group
    • cw tail -f my-log-group:my-log-stream-prefix
    • cw tail -f my-log-group:my-log-stream-prefix my-log-group2
    • cw tail -f my-log-group:my-log-stream-prefix -b2017-01-01T08:10:10 -e2017-01-01T08:05:00
    • cw tail -f my-log-group:my-log-stream-prefix -b7d للبدء من 7 أيام.
    • cw tail -f my-log-group:my-log-stream-prefix -b3h للبدء من 3 ساعات.
    • cw tail -f my-log-group:my-log-stream-prefix -b100m للبدء من 100 دقيقة.
    • cw tail -f my-log-group:my-log-stream-prefix -b2h30m للبدء من ساعتين و 30 دقيقة.
    • cw tail -f my-log-group -b9:00 -e9:01

  • استعلام سجلات JSON باستخدام بناء جملة JMESPATH

    • cw tail -f my-log-group --query "machines[?state=='running'].name"

الوقت والتواريخ

يتم التعامل مع الوقت والتواريخ على أنها UTC افتراضيًا. استخدم العلم --local إذا كنت تفضل استخدام المنطقة المحلية.

بيانات اعتماد AWS والتكوين

يستخدم cw ملف تعريف بيانات الاعتماد الافتراضية (المخزنة في ./aws/credentials) للمصادقة والتكوين المشترك (.AWS/config) لتحديد منطقة AWS الهدف. يتم تجاوز كل من الملف الشخصي والمنطقة من خلال الأعلام العالمية profile region .

AWS SSO

يتم دعم AWS SSO إذا كنت:

  • استخدم ملف تعريف CLI (إما default أو ملف تعريف بديل مسمى) يتضمن خصائص SSO المختلفة
    • sso_start_url ، sso_account_id ، sso_role_name ، إلخ
  • احصل على جلسة SSO النشطة والنشطة
    • عبر aws sso login

إذا تلقيت رسالة خطأ تتضمن ...failed to sign request: failed to retrieve credentials: the SSO session has expired or is invalid... فيجب عليك تجديد جلسة SSO الخاصة بك عبر aws sso login (وتحديد ملف التعريف المسماة ، إذا كان ذلك مناسبًا).

متنوع

استخدم cw وراء الوكيل

يرجى استخدام متغير البيئة HTTP_PROXY كما هو مطلوب من قبل AWS CLI: https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-proxy.html

كسر التغييرات ملاحظات

اقرأ هنا

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل