ഡോക്യുമെൻ്റ് പരാജയങ്ങൾ പരിഹരിക്കുന്നതിന് ലോഗുകൾ ആവശ്യമാണ്, എന്നാൽ മുഴുവൻ വാചകവും ലോഗ് ചെയ്യേണ്ട ആവശ്യമില്ല.
വിവർത്തന പരാജയങ്ങൾ കണ്ടെത്തുന്നതിന് ലോഗുകൾ ആവശ്യമാണ്, എന്നാൽ മുഴുവൻ കരാറും ഐഡി നമ്പറും ഡൗൺലോഡ് ടോക്കണും പ്രിൻ്റ് ചെയ്യേണ്ടതില്ല. അനുമതി മാനേജ്മെൻ്റ് ഇല്ലാത്ത രണ്ടാമത്തെ ഡോക്യുമെൻ്റ് ലൈബ്രറിയായി മാറുന്നതിന് പകരം "ഏത് ടാസ്ക്, ഏത് ഘട്ടത്തിലാണ്, എന്തുകൊണ്ട് ഇത് പരാജയപ്പെട്ടു" എന്നതിന് ലോഗ് ഉത്തരം നൽകണം.
ഡോക്യുമെൻ്റ് വിവർത്തന പരാജയങ്ങൾ പരിഹരിക്കുന്നതിന് ലോഗുകൾ ആവശ്യമാണ്, എന്നാൽ കരാറിൻ്റെ മുഴുവൻ വാചകമോ ഐഡി നമ്പറോ ഡൗൺലോഡ് ടോക്കണോ ലോഗുകളിൽ അടങ്ങിയിരിക്കേണ്ടതില്ല. ഉപഭോക്തൃ രേഖകൾ ലോഗിലേക്ക് പകർത്താതെ "ഏത് ടാസ്ക് ഏത് ഘട്ടത്തിലാണ് പരാജയപ്പെട്ടത്, എന്തുകൊണ്ട്" എന്ന രേഖ ഉത്തരം എങ്ങനെ നിർമ്മിക്കാമെന്ന് ഈ ലേഖനം വിശദീകരിക്കുന്നു.
ഡോക്യുമെൻ്റ് വിവർത്തന സേവനങ്ങൾ, ഡോക്കിംഗ് വിവർത്തന ഇൻ്റർഫേസുകൾ അല്ലെങ്കിൽ പശ്ചാത്തല ലോഗുകൾ പരിപാലിക്കൽ എന്നിവയ്ക്ക് ഉത്തരവാദികളായ ഡെവലപ്പർമാരും ഓപ്പറേഷൻ, മെയിൻ്റനൻസ് ഉദ്യോഗസ്ഥരുമാണ് അനുയോജ്യമായ വായനക്കാർ. വായിച്ചതിനുശേഷം, നിങ്ങൾക്ക് വൈറ്റ്ലിസ്റ്റ് ഫീൽഡുകളുടെ ഒരു കൂട്ടം രൂപകൽപ്പന ചെയ്യാനും ലോഗ് യഥാർത്ഥ വാചകം പുറത്തെടുക്കുന്നില്ലെന്ന് സ്ഥിരീകരിക്കാനും ട്രബിൾഷൂട്ടിംഗിനായി നിലനിർത്തൽ കാലയളവും ആക്സസ് സ്കോപ്പും സജ്ജമാക്കാനും കഴിയും.
പ്രോസസ്സിംഗ് രീതികൾ കാണിക്കുന്നതിന് ഉദാഹരണങ്ങൾ സിന്തറ്റിക് സാമ്പിളുകൾ ഉപയോഗിക്കുന്നു, കൂടാതെ കോഡ് ഒരു ഒറ്റപ്പെട്ട പരിതസ്ഥിതിയിൽ പരിശോധിച്ചു, എന്നാൽ ഇത് എല്ലാ യഥാർത്ഥ ഫയലുകളുടെയും ഉൽപ്പന്ന പ്രകടനത്തിൻ്റെയും ഗ്യാരണ്ടിയെ പ്രതിനിധീകരിക്കുന്നില്ല. പ്രധാനപ്പെട്ട ഡോക്യുമെൻ്റുകൾ പ്രോസസ്സ് ചെയ്യുന്നതിന് മുമ്പ്, ഒറിജിനലുകൾ സൂക്ഷിക്കുകയും ചുവടെയുള്ള അതിരുകളും സ്വീകാര്യ ഇനങ്ങളും അനുസരിച്ച് അവ അവലോകനം ചെയ്യുകയും ചെയ്യുക.
ട്രബിൾഷൂട്ടിംഗ് ലോഗിൽ എന്താണ് രേഖപ്പെടുത്തേണ്ടത്? ഒരു വാക്യത്തിൻ്റെ ഉപസംഹാരം
ടാസ്ക് ഐഡി, ഘട്ടം, പിശക് വിഭാഗം, സമയ ഉപഭോഗം എന്നിവ പോലുള്ള അനുവദനീയമായ ഫീൽഡുകൾ മാത്രമേ ലോഗ് രേഖപ്പെടുത്തുകയുള്ളൂ, എന്നാൽ ഡോക്യുമെൻ്റ് ഉള്ളടക്കവും ക്രെഡൻഷ്യലുകളും രേഖപ്പെടുത്തുന്നില്ല.
| നിങ്ങളുടെ അവസ്ഥ | ശുപാർശ ചെയ്യുന്ന സമ്പ്രദായങ്ങൾ | കാരണം |
|---|---|---|
| ഏത് ജോലിയാണ് പരാജയപ്പെട്ടതെന്ന് അറിയണം | ഒരു റാൻഡം ഇൻ്റേണൽ ടാസ്ക് ഐഡി ലോഗ് ചെയ്യുന്നു | ഉപയോക്തൃ ഫയൽ നാമങ്ങളോ പാതകളോ വെളിപ്പെടുത്താതെ പ്രശ്നങ്ങൾ കണ്ടെത്താനുള്ള കഴിവ് |
| കാർഡ് ഏത് ഘട്ടത്തിലാണെന്ന് നിർണ്ണയിക്കേണ്ടതുണ്ട് | സ്റ്റേജിൻ്റെ പേരും എടുത്ത സമയവും രേഖപ്പെടുത്തുക | ഓരോ സോഴ്സ് ടെക്സ്റ്റും വിവർത്തനവും ആവശ്യമില്ല |
| അഭ്യർത്ഥന അപ്സ്ട്രീം നിരസിച്ചു | നോർമലൈസ് ചെയ്ത പിശക് വിഭാഗങ്ങൾ ലോഗ് ചെയ്യുക | ആധികാരികത ഫസ്റ്റ് ക്ലാസ് പൂർണ്ണമായ അഭ്യർത്ഥന ഉള്ളടക്കം ലോഗിൽ നൽകരുത് |
| ട്രബിൾഷൂട്ടിംഗിനായി ഒറിജിനലിലേക്ക് തിരികെ പോകേണ്ടതുണ്ട് | നിയന്ത്രിത സിസ്റ്റത്തിനുള്ളിൽ റഫറൻസുകൾ ഉപയോഗിക്കുന്നു | ശാശ്വതമായി പൊതുവായി ഡൗൺലോഡ് ചെയ്യാൻ കഴിയുന്ന ലിങ്കുകൾ ചോർന്നുപോകാനുള്ള സാധ്യതയുണ്ട് |
റെക്കോർഡ് ചെയ്യാൻ അനുവദിച്ചിരിക്കുന്ന ഫീൽഡുകൾ ഉപയോഗിച്ച് ആരംഭിക്കുക
ബ്ലാക്ക്ലിസ്റ്റിന് പുതിയ സെൻസിറ്റീവ് ഫീൽഡുകൾ എളുപ്പത്തിൽ നഷ്ടമാകും. രൂപകൽപ്പന ചെയ്ത ഫീൽഡുകൾ മാത്രം ഔട്ട്പുട്ട് ചെയ്യുക എന്നതാണ് കൂടുതൽ വിവേകപൂർണ്ണമായ സമീപനം, ഉദാഹരണത്തിന്:
- ആന്തരിക ടാസ്ക് ഐഡി
- പ്രോസസ്സിംഗ് ഘട്ടം
- പിശക് വിഭാഗം
- സമയം ചെലവഴിക്കുന്ന
ചുവടെയുള്ള സിന്തസിസ് ഉദാഹരണം വൈറ്റ്ലിസ്റ്റ് പ്രൊജക്ഷൻ ഉപയോഗിക്കുന്നതിനാൽ ഇൻപുട്ടിലെ മുഴുവൻ വാചകങ്ങളും ടോക്കണുകളും ലോഗിൽ നൽകില്ല.
സ്ഥിരീകരണ ലോഗ് യഥാർത്ഥ വാചകം പുറത്തെടുത്തില്ല.
import io
import json
import logging
ALLOWED = ("job_id", "stage", "error_code", "elapsed_ms")
def log_record(data):
return {key: data[key] for key in ALLOWED if key in data}
stream = io.StringIO()
logger = logging.getLogger("synthetic-document-job")
logger.handlers.clear()
logger.propagate = False
logger.setLevel(logging.INFO)
handler = logging.StreamHandler(stream)
logger.addHandler(handler)
event = {"job_id": "demo-12", "stage": "parse", "error_code": "BAD_CONTAINER",
"elapsed_ms": 42, "document_text": "synthetic confidential clause",
"access_token": "synthetic-secret"}
logger.info(json.dumps(log_record(event), sort_keys=True))
logged = json.loads(stream.getvalue())
assert logged["error_code"] == "BAD_CONTAINER"
assert "document_text" not in logged
assert "synthetic-secret" not in stream.getvalue()
assert set(logged) <= set(ALLOWED)
logger.removeHandler(handler)
ഉദാഹരണം സ്വയം നാമകരണം ചെയ്ത ഡെമോ ലോഗറിനെ മാത്രമേ പരിഷ്കരിക്കൂ. ബിസിനസ്സ് ലൈബ്രറിയിൽ ആപ്ലിക്കേഷൻ ഗ്ലോബൽ ഹാൻഡ്ലർ മായ്ക്കാൻ ശുപാർശ ചെയ്യുന്നില്ല. നീളത്തിനും തരത്തിനും ഫീൽഡ് മൂല്യങ്ങൾ ഇപ്പോഴും പരിശോധിക്കേണ്ടതുണ്ട്. നിങ്ങൾ ഉപയോക്താവിൻ്റെ മുഴുവൻ വാചകവും error_code-ലേക്ക് ക്രാം ചെയ്യുകയാണെങ്കിൽ പേരുകൾ വൈറ്റ്ലിസ്റ്റ് ചെയ്യുന്നത് നിങ്ങളെ സംരക്ഷിക്കില്ല.
സെൻസിറ്റീവ് ഉള്ളടക്കത്തിൻ്റെ സ്ഥാനത്ത് അസോസിയേഷൻ ഐഡി
ട്രബിൾഷൂട്ടിംഗ് സമയത്ത് പൊതുവായ ആവശ്യകതകളും ശുപാർശ ചെയ്യുന്നതും ശുപാർശ ചെയ്യാത്തതുമായ റെക്കോർഡുകളും ഇനിപ്പറയുന്ന പട്ടിക പട്ടികപ്പെടുത്തുന്നു.
| അന്വേഷിക്കേണ്ട പ്രശ്നങ്ങൾ | ശുപാർശ ചെയ്ത രേഖകൾ | റെക്കോർഡ് ശുപാർശ ചെയ്തിട്ടില്ല |
|---|---|---|
| ഏത് ടാസ്ക് പരാജയപ്പെട്ടു | ക്രമരഹിതമായ ആന്തരിക ടാസ്ക് ഐഡി | ഉപയോക്താവിൻ്റെ പൂർണ്ണമായ ഫയലിൻ്റെ പേരും പാതയും |
| ഏത് ഘട്ടം സമയമെടുക്കും? | ഘട്ടങ്ങളും സമയമെടുക്കുന്നതും | ഓരോ ഉറവിട വാചകവും വിവർത്തനവും |
| എന്തുകൊണ്ടാണ് അപ്സ്ട്രീം നിരസിച്ചത്? | സാധാരണവൽക്കരിച്ച പിശക് വിഭാഗങ്ങൾ | പ്രാമാണീകരണ തലക്കെട്ടിനൊപ്പം അഭ്യർത്ഥന പൂർത്തിയാക്കുക |
| ഒറിജിനൽ എങ്ങനെ കണ്ടെത്താം | നിയന്ത്രിത സിസ്റ്റങ്ങൾക്കുള്ളിലെ റഫറൻസുകൾ | ശാശ്വതമായി പൊതു ഡൗൺലോഡ് ലിങ്ക് |
നിലനിർത്തൽ കാലയളവ് ആക്സസ് സ്കോപ്പിന് തുല്യമാണ്
ലോഗിൽ ടെക്സ്റ്റ് ഇല്ലെങ്കിലും, ടാസ്ക് സമയം, ഭാഷ, ഫയൽ വലുപ്പം എന്നിവയുടെ സംയോജനം ബിസിനസ്സ് വിവരങ്ങൾ വെളിപ്പെടുത്തിയേക്കാം. പ്രവേശന നിയന്ത്രണങ്ങൾ, നിലനിർത്തൽ കാലയളവുകൾ, ഇല്ലാതാക്കൽ നടപടിക്രമങ്ങൾ എന്നിവയ്ക്കൊപ്പം ലോഗുകൾ ഉണ്ടായിരിക്കണം.
ട്രബിൾഷൂട്ട് ചെയ്യുമ്പോൾ, ലോഗ് ലെവൽ താൽക്കാലികമായി വർദ്ധിപ്പിക്കുകയും ദീർഘകാലത്തേക്ക് ഡീബഗ് മോഡ് ഉൽപ്പാദന പരിതസ്ഥിതിയിൽ ഉപേക്ഷിക്കാതിരിക്കാൻ എപ്പോൾ പുനഃസ്ഥാപിക്കണമെന്ന് വ്യക്തമാക്കുകയും ചെയ്യുക.
വിവർത്തന സംയോജനത്തിന് വ്യക്തവും നിയന്ത്രിതവുമായ ലോഗുകളും ഉണ്ടായിരിക്കാം
OmniDoc (ഉൽപ്പന്ന പോർട്ടൽ)-ലേക്ക് കണക്റ്റുചെയ്യുമ്പോൾ, പ്രാദേശിക ടാസ്ക്കുകളും റിമോട്ട് ടാസ്ക്കുകളും തമ്മിലുള്ള ബന്ധം മാത്രം രേഖപ്പെടുത്തേണ്ടതുണ്ട്. ട്രബിൾഷൂട്ടിംഗ് സൗകര്യത്തിനായി ഉപയോക്താക്കൾ അപ്ലോഡ് ചെയ്യുന്ന ഫയലുകൾ ലോഗിലേക്ക് പകർത്താൻ പാടില്ല.
അംഗീകൃത പ്രോസസ്സിംഗ് പാതകളിൽ മാത്രം ഉപഭോക്തൃ രേഖകൾ ഒഴുകുന്ന സമയത്ത്, ഒരു നല്ല പ്രശ്ന റിപ്പോർട്ട് പരാജയത്തിൻ്റെ ഘട്ടവും ആവർത്തന അവസ്ഥയും വിവരിക്കുന്നു.
അവലംബങ്ങൾ: Python logging.
📊 പ്രധാന താരതമ്യം
| വഴി | നേട്ടം | അപകടം |
|---|---|---|
| കരിമ്പട്ടിക | എഴുത്ത് രീതി ലളിതവും ഉപയോഗിക്കാൻ എളുപ്പവുമാണ്. | പുതിയ സെൻസിറ്റീവ് ഫീൽഡുകൾ നഷ്ടപ്പെടുത്തുന്നത് എളുപ്പമാണ് |
| വൈറ്റ്ലിസ്റ്റ് | വ്യക്തമായ അതിരുകളോടെ രൂപകല്പന ചെയ്ത ഫീൽഡുകൾ മാത്രം ഔട്ട്പുട്ട് ചെയ്യുക | ഫീൽഡുകൾ മുൻകൂട്ടി ആസൂത്രണം ചെയ്യുകയും ഫീൽഡ് മൂല്യങ്ങളുടെ നീളവും തരവും പരിശോധിച്ചുറപ്പിക്കുകയും വേണം |
🎯 ഏത് രീതിയാണ് നിങ്ങൾക്ക് അനുയോജ്യം?
നിങ്ങൾക്ക് ഒരു വിവർത്തന ചുമതല കണ്ടെത്തണമെങ്കിൽ
റാൻഡം ഇൻ്റേണൽ ടാസ്ക് ഐഡികളും പരാജയത്തിൻ്റെ ഘട്ടങ്ങളും ലോഗിൻ ചെയ്യുന്നു, പൂർണ്ണമായ ഉപയോക്തൃ ഫയൽനാമങ്ങളോ പാതകളോ ലോഗിൻ ചെയ്യുന്നില്ല.
നിങ്ങൾക്ക് അപ്സ്ട്രീം ഇൻ്റർഫേസ് റിപ്പോർട്ട് ചെയ്ത പിശകുകൾ കൈകാര്യം ചെയ്യണമെങ്കിൽ
നോർമലൈസ് ചെയ്ത പിശക് ക്ലാസുകൾ ലോഗിൻ ചെയ്യുന്നു, ആധികാരികത തലക്കെട്ടുകൾ ഉപയോഗിച്ച് പൂർണ്ണമായ അഭ്യർത്ഥനകൾ ലോഗ് ചെയ്യരുത്.
നിങ്ങൾ ഓൺലൈൻ പ്രശ്നങ്ങൾ ട്രബിൾഷൂട്ട് ചെയ്യുകയാണെങ്കിൽ
ലോഗ് ലെവൽ താൽക്കാലികമായി വർദ്ധിപ്പിക്കുകയും ട്രബിൾഷൂട്ടിംഗിന് ശേഷം അത് പുനഃസ്ഥാപിക്കുകയും ചെയ്യുക.
നിങ്ങൾക്ക് ലോഗ് ഫീൽഡുകൾ രൂപകൽപ്പന ചെയ്യണമെങ്കിൽ
വൈറ്റ്ലിസ്റ്റിംഗ് തിരഞ്ഞെടുത്ത് ഫീൽഡ് മൂല്യങ്ങളുടെ ദൈർഘ്യവും തരവും പരിശോധിച്ചുറപ്പിക്കുക.
❓ പതിവായി ചോദിക്കുന്ന ചോദ്യങ്ങൾ (FAQ)
1. ഉപയോക്താവിൻ്റെ പൂർണ്ണമായ ഫയലിൻ്റെ പേര് ലോഗിൽ രേഖപ്പെടുത്താൻ കഴിയുമോ?
ശുപാർശ ചെയ്തിട്ടില്ല. പൂർണ്ണമായ ഫയലിൻ്റെ പേരും പാതയും റെക്കോർഡ് ചെയ്യാൻ ശുപാർശ ചെയ്യുന്നില്ല, പകരം റാൻഡം ഇൻ്റേണൽ ടാസ്ക് ഐഡി കോറിലേഷൻ ഉപയോഗിക്കാം.
2. സെൻസിറ്റീവ് ഫീൽഡുകൾ ഫിൽട്ടർ ചെയ്യുന്നതിന് ബ്ലാക്ക്ലിസ്റ്റ് ഉപയോഗിക്കാൻ ശുപാർശ ചെയ്യാത്തത് എന്തുകൊണ്ട്?
ബ്ലാക്ക്ലിസ്റ്റിന് പുതിയ സെൻസിറ്റീവ് ഫീൽഡുകൾ എളുപ്പത്തിൽ നഷ്ടമാകും, അതേസമയം വൈറ്റ്ലിസ്റ്റ് രൂപകൽപ്പന ചെയ്ത ഫീൽഡുകൾ മാത്രമേ ഔട്ട്പുട്ട് ചെയ്യുന്നുള്ളൂ, അത് കൂടുതൽ സുരക്ഷിതമാണ്.
3. ടാസ്ക് സമയവും ഫയൽ വലുപ്പവും മാത്രം കൈകാര്യം ചെയ്യേണ്ടതുണ്ടോ?
ആവശ്യം. ഈ വിവരങ്ങളുടെ സംയോജനം ബിസിനസ്സ് വിവരങ്ങളും വെളിപ്പെടുത്തിയേക്കാം, കൂടാതെ ആക്സസ് നിയന്ത്രണങ്ങൾ, നിലനിർത്തൽ കാലയളവുകൾ, ഇല്ലാതാക്കൽ നടപടിക്രമങ്ങൾ എന്നിവയ്ക്കൊപ്പം ലോഗുകളും ഉണ്ടായിരിക്കണം.
4. ട്രബിൾഷൂട്ട് ചെയ്യുമ്പോൾ ഡീബഗ്ഗിംഗ് ലോഗുകൾ ദീർഘനേരം ഓണാക്കാൻ കഴിയുമോ?
ശുപാർശ ചെയ്തിട്ടില്ല. ലോഗ് ലെവൽ താൽക്കാലികമായി വർദ്ധിപ്പിച്ച ശേഷം, ദീർഘകാലത്തേക്ക് ഉൽപ്പാദന പരിതസ്ഥിതിയിൽ ഡീബഗ് മോഡ് ഉപേക്ഷിക്കുന്നത് ഒഴിവാക്കാൻ അത് എപ്പോൾ പുനഃസ്ഥാപിക്കണമെന്ന് അറിയേണ്ടത് ആവശ്യമാണ്.
5. ബിസിനസ് ലൈബ്രറിയിൽ ഗ്ലോബൽ ഹാൻഡ്ലർ ക്ലിയർ ചെയ്യാൻ കഴിയുമോ?
ശുപാർശ ചെയ്തിട്ടില്ല. ഉദാഹരണം സ്വയം നാമകരണം ചെയ്ത ഡെമോ ലോഗറിനെ മാത്രമേ പരിഷ്ക്കരിക്കുന്നുള്ളൂ, ബിസിനസ്സ് ലൈബ്രറിയിൽ ആപ്ലിക്കേഷൻ ഗ്ലോബൽ ഹാൻഡ്ലർ മായ്ക്കരുത്.
📝 സംഗ്രഹം
വിവർത്തന പരാജയങ്ങളുടെ ട്രബിൾഷൂട്ട് ചെയ്യുമ്പോൾ, ഡോക്യുമെൻ്റ് ഉള്ളടക്കം സംരക്ഷിക്കുന്നതിനുപകരം ലോഗുകൾ ചുമതലകൾ, ഘട്ടങ്ങൾ, കാരണങ്ങൾ എന്നിവയ്ക്ക് ഉത്തരം നൽകണം. ട്രബിൾഷൂട്ടിംഗ് കാര്യക്ഷമതയും പ്രമാണ സുരക്ഷയും സന്തുലിതമാക്കാൻ വൈറ്റ്ലിസ്റ്റ് ഫീൽഡുകൾ, നിയന്ത്രിത റഫറൻസുകൾ, വ്യക്തമായ നിലനിർത്തൽ കാലയളവുകൾ എന്നിവ ഉപയോഗിക്കുക.
ഇപ്പോൾ ശ്രമിക്കുക: വിവർത്തനം ആരംഭിക്കാൻ പ്രമാണം അപ്ലോഡ് ചെയ്യുക, യഥാർത്ഥ ലേഔട്ട് നിലനിർത്തുക


